Compartir a través de


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
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.

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