Función mixerGetControlDetails (mmeapi.h)
La función mixerGetControlDetails recupera detalles sobre un único control asociado a una línea de audio.
Sintaxis
MMRESULT mixerGetControlDetails(
HMIXEROBJ hmxobj,
LPMIXERCONTROLDETAILS pmxcd,
DWORD fdwDetails
);
Parámetros
hmxobj
Identificador del objeto de dispositivo mezclador que se consulta.
pmxcd
Puntero a una estructura MIXERCONTROLDETAILS , que se rellena con información de estado sobre el control.
fdwDetails
Marcas para recuperar los detalles del control. Se definen los valores siguientes.
Valor | Significado |
---|---|
MIXER_GETCONTROLDETAILSF_LISTTEXT | El miembro paDetails de la estructura MIXERCONTROLDETAILS apunta a una o varias estructuras de MIXERCONTROLDETAILS_LISTTEXT para recibir etiquetas de texto para controles de varios elementos. Una aplicación debe obtener todos los elementos de texto de lista para un control de varios elementos a la vez. Esta marca no se puede usar con controles MIXERCONTROL_CONTROLTYPE_CUSTOM. |
MIXER_GETCONTROLDETAILSF_VALUE | Se recuperan los valores actuales de un control. El miembro paDetails de la estructura MIXERCONTROLDETAILS apunta a una o varias estructuras de detalles adecuadas para la clase de control. |
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 controlador de un dispositivo de entrada MIDI (Musical Instrument Digital Interface). La función midiInOpen debe haber devuelto este identificador. |
MIXER_OBJECTF_HMIDIOUT | El parámetro hmxobj es el controlador 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 controlador de entrada de audio de forma de onda devuelto por la función waveInOpen . |
MIXER_OBJECTF_HWAVEOUT | El parámetro hmxobj es un controlador 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 el identificador de un 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 . |
Valor devuelto
Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.
Código devuelto | Descripción |
---|---|
|
La referencia de control no es válida. |
|
El parámetro hmxobj especifica un identificador de dispositivo no válido. |
|
Una o varias marcas no son válidas. |
|
El parámetro hmxobj especifica un identificador no válido. |
|
Uno o varios parámetros no son válidos. |
|
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 esta función.
Requisitos
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 Mmeapi.h, Windows.h) |
Library | Winmm.lib |
Archivo DLL | Winmm.dll |