Compartir a través de


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

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

Consulte también

Funciones de mezclador de audio

Mezcladores de audio