Función mixerSetControlDetails (mmeapi.h)

La función mixerSetControlDetails establece las propiedades de un único control asociado a una línea de audio.

Sintaxis

MMRESULT mixerSetControlDetails(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

Parámetros

hmxobj

Identificador del objeto de dispositivo mezclador para el que se establecen las propiedades.

pmxcd

Puntero a una estructura MIXERCONTROLDETAILS . Esta estructura se usa para hacer referencia a estructuras de detalles de control que contienen el estado deseado para el control.

fdwDetails

Marcas para establecer propiedades para un control. Se definen los valores siguientes.

Valor	Significado
MIXER_OBJECTF_AUX	El parámetro hmxobj es un identificador de dispositivo auxiliar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función auxGetNumDevs .
MIXER_OBJECTF_HMIDIIN	El parámetro hmxobj es el identificador de un dispositivo de entrada MIDI. La función midiInOpen debe haber devuelto este identificador.
MIXER_OBJECTF_HMIDIOUT	El parámetro hmxobj es el identificador de un dispositivo de salida MIDI. La función midiOutOpen debe haber devuelto este identificador.
MIXER_OBJECTF_HMIXER	El parámetro hmxobj es un identificador de dispositivo mezclador devuelto por la función mixerOpen . Esta marca es opcional.
MIXER_OBJECTF_HWAVEIN	El parámetro hmxobj es un identificador de entrada de forma de onda devuelto por la función waveInOpen .
MIXER_OBJECTF_HWAVEOUT	El parámetro hmxobj es un identificador de salida de audio de forma de onda devuelto por la función waveOutOpen .
MIXER_OBJECTF_MIDIIN	El parámetro hmxobj es el identificador de un dispositivo de entrada MIDI. Este identificador debe estar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función midiInGetNumDevs .
MIXER_OBJECTF_MIDIOUT	El parámetro hmxobj es el identificador de un dispositivo de salida MIDI. Este identificador debe estar en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función midiOutGetNumDevs .
MIXER_OBJECTF_MIXER	El parámetro hmxobj es un identificador de dispositivo mezclador en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función mixerGetNumDevs . Esta marca es opcional.
MIXER_OBJECTF_WAVEIN	El parámetro hmxobj es el identificador de un dispositivo de entrada de audio de forma de onda en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función waveInGetNumDevs .
MIXER_OBJECTF_WAVEOUT	El parámetro hmxobj es el identificador de un dispositivo de salida de audio de forma de onda en el intervalo de cero a uno menor que el número de dispositivos devueltos por la función waveOutGetNumDevs .
MIXER_SETCONTROLDETAILSF_CUSTOM	Se muestra un cuadro de diálogo personalizado para el control mezclador personalizado especificado. El dispositivo mezclador recopila la información necesaria del usuario y devuelve los datos del búfer especificado. El identificador de la ventana propietaria se especifica en el miembro hwndOwner de la estructura MIXERCONTROLDETAILS . (Este identificador se puede establecer en NULL). A continuación, la aplicación puede guardar los datos del cuadro de diálogo y usarlos más adelante para restablecer el control al mismo estado mediante la marca MIXER_SETCONTROLDETAILSF_VALUE.
MIXER_SETCONTROLDETAILSF_VALUE	Se establecen los valores actuales de un control. El miembro paDetails de la estructura MIXERCONTROLDETAILS apunta a una o varias estructuras de detalles de control de mezclador de la clase adecuada para el control.

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
MIXERR_INVALCONTROL	La referencia de control no es válida.
MMSYSERR_BADDEVICEID	El parámetro hmxobj especifica un identificador de dispositivo no válido.
MMSYSERR_INVALFLAG	Una o varias marcas no son válidas.
MMSYSERR_INVALHANDLE	El parámetro hmxobj especifica un identificador no válido.
MMSYSERR_INVALPARAM	Uno o varios parámetros no son válidos.
MMSYSERR_NODRIVER	No hay ningún dispositivo mezclador disponible para el objeto especificado por hmxobj.

Comentarios

Todos los miembros de la estructura MIXERCONTROLDETAILS deben inicializarse antes de llamar a mixerSetControlDetails.

Si una aplicación necesita recuperar solo el estado actual de un control mezclador personalizado y no mostrar un cuadro de diálogo, se puede usar mixerGetControlDetails con la marca MIXER_GETCONTROLDETAILSF_VALUE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mmeapi.h (incluya Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Funciones de mezclador de audio

Mezcladores de audio