Compartir a través de


Función waveOutGetDevCaps (mmeapi.h)

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

Syntax

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 va a 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 ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código de retorno Description
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.

Observaciones

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 los bytes cbwoc (o menos) de la información se copian en la ubicación a la que apunta pwoc. Si cbwoc es cero, no se copia nada y la función devuelve cero.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header mmeapi.h (incluya Windows.h)
Library Winmm.lib
DLL de Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda