Compartir a través de

función auxGetDevCapsA (mmeapi.h)

  • Artículo

La función auxGetDevCaps recupera las funcionalidades de un dispositivo de salida auxiliar determinado.

Sintaxis

MMRESULT auxGetDevCapsA(
  UINT_PTR   uDeviceID,
  LPAUXCAPSA pac,
  UINT       cbac
);

Parámetros

uDeviceID

Identificador del dispositivo de salida auxiliar que se va a consultar. Especifique un identificador de dispositivo válido (consulte la siguiente sección de comentarios) o use la constante siguiente:

Valor Significado
AUX_MAPPER Asignador de audio auxiliar. La función devuelve un error si no hay instalado ningún asignador de audio auxiliar.

pac

Puntero a una estructura AUXCAPS que se va a rellenar con información sobre las funcionalidades del dispositivo.

cbac

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

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.

Comentarios

El identificador de dispositivo en uDeviceID varía de cero a uno menor que el número de dispositivos presentes. también se puede usar AUX_MAPPER. Use la función auxGetNumDevs para determinar el número de dispositivos de salida auxiliares presentes en el sistema.

Nota:

El encabezado mmeapi.h define auxGetDevCaps 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

Audio de forma de onda

Funciones de forma de onda