Función waveOutGetDevCaps (mmeapi.h)

La función waveOutGetDevCaps recupera las funcionalidades de un dispositivo de salida de audio de forma de onda determinado.

Sintaxis

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

Parámetros

uDeviceID

Identificador del dispositivo de salida de audio de forma de onda. Puede ser un identificador de dispositivo o un identificador de un dispositivo de salida de audio de forma de onda abierto.

pwoc

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

cbwoc

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

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_NODRIVER	No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM	No se puede asignar o bloquear la memoria.

Comentarios

Use la función waveOutGetNumDevs para determinar el número de dispositivos de salida de audio de forma de onda presentes en el sistema. Si el valor especificado por el parámetro uDeviceID es un identificador de dispositivo, puede variar de cero a uno menor que el número de dispositivos presentes. La constante WAVE_MAPPER también se puede usar como identificador de dispositivo. Solo se copian bytes cbwoc (o menos) de información en la ubicación a la que apunta pwoc. Si cbwoc es cero, no se copia nada y la función devuelve cero.

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

Audio de forma de onda

Funciones de forma de onda