Compartir a través de


Función waveOutGetDevCapsA (mmeapi.h)

La función waveOutGetDevCapsA recupera las funcionalidades de un dispositivo de salida de audio de forma de onda determinado. Esta es la versión ANSI de la función.

Syntax

MMRESULT waveOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSA 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 WAVEOUTCAPSA que se va a rellenar con información sobre las funcionalidades del dispositivo.

cbwoc

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

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
Servidor mínimo admitido Windows 2000 Server
Header mmeapi.h
Library Winmm.lib
DLL de Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda