Función mixerGetDevCapsA (mmeapi.h)

La función mixerGetDevCaps consulta un dispositivo mezclador especificado para determinar sus funcionalidades.

Sintaxis

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

Parámetros

uMxId

Identificador o identificador de un dispositivo mezclador abierto.

pmxcaps

Puntero a una estructura de MIXERCAPS que recibe información sobre las funcionalidades del dispositivo.

cbmxcaps

Tamaño, en bytes, de la estructura de MIXERCAPS.

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
MMSYSERR_BADDEVICEID	El identificador de dispositivo especificado está fuera del intervalo.
MMSYSERR_INVALHANDLE	El identificador del dispositivo mezclador no es válido.
MMSYSERR_INVALPARAM	Uno o varios parámetros no son válidos.

Observaciones

Use la función mixerGetNumDevs para determinar el número de dispositivos mezcladores presentes en el sistema. El identificador de dispositivo especificado por uMxId varía de cero a uno menor que el número de dispositivos mezclador presentes.

Solo el número de bytes (o menos) de información especificada en cbmxcaps se copia en la ubicación a la que apunta pmxcaps. Si cbmxcaps es cero, no se copia nada y la función devuelve correctamente.

Esta función también acepta un identificador de dispositivo mezclador devuelto por la función de mezcladorAbrir como parámetro uMxId. La aplicación debe convertir el identificador de HMIXER en unUINT de .

Nota

El encabezado mmeapi.h define mixerGetDevCaps 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 Windows.h)
biblioteca de	Winmm.lib
DLL de	Winmm.dll

Consulte también

funciones de mezclador de audio de

mezcladores de audio de