Función mixerGetControlDetailsW (mmeapi.h)

La función mixerGetControlDetails recupera detalles sobre un único control asociado a una línea de audio.

Sintaxis

MMRESULT mixerGetControlDetailsW(
  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
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 esta función.

Nota:

El encabezado mmeapi.h define mixerGetControlDetails como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de 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

Consulte también

Funciones de mezclador de audio

Mezcladores de audio