Compartir a través de

Función mixerGetControlDetailsA (mmeapi.h)

  • Artículo

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

Sintaxis

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

Parámetros

hmxobj

Identificador del objeto de dispositivo mezclador que se está consultando.

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

Valor Significado
MIXER_GETCONTROLDETAILSF_LISTTEXT El miembro paDetails del 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 del 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 (Interfaz Digital instrumenta musical). 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.

Observaciones

Todos los miembros de la MIXERCONTROLDETAILS estructura 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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de mmeapi.h (incluya Mmeapi.h, Windows.h)
biblioteca de Winmm.lib
DLL de Winmm.dll

Consulte también

funciones de mezclador de audio de

mezcladores de audio de