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 |
|---|---|
|
El identificador de dispositivo especificado está fuera del intervalo. |
|
No hay ningún controlador de dispositivo presente. |
|
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 |