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 MIXERCAPS que recibe información sobre las funcionalidades del dispositivo.
cbmxcaps
Tamaño, en bytes, de la estructura MIXERCAPS .
Valor devuelto
Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.
| Código devuelto | Descripción |
|---|---|
|
El identificador de dispositivo especificado está fuera del intervalo. |
|
El identificador del dispositivo mezclador no es válido. |
|
Uno o varios parámetros no son válidos. |
Comentarios
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 mezcladores 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 mixerOpen como el parámetro uMxId . La aplicación debe convertir el identificador HMIXER en un UINT.
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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 Windows.h) |
| Library | Winmm.lib |
| Archivo DLL | Winmm.dll |