Compartir a través de

Función mixerGetDevCaps (mmeapi.h)

  • Artículo

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