Función mixerGetDevCaps (mmeapi.h)

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

Sintaxis

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS 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.

Requisitos

Requisito	Value
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