fonction waveOutGetDevCaps (mmeapi.h)
La fonction waveOutGetDevCaps récupère les fonctionnalités d’un périphérique de sortie audio de forme d’onde donnée.
Syntaxe
MMRESULT waveOutGetDevCaps(
UINT uDeviceID,
LPWAVEOUTCAPS pwoc,
UINT cbwoc
);
Paramètres
uDeviceID
Identificateur du périphérique de sortie audio de forme d’onde. Il peut s’agir d’un identificateur d’appareil ou d’une poignée d’un périphérique de sortie audio de forme d’onde ouverte.
pwoc
Pointeur vers une structure WAVEOUTCAPS à remplir avec des informations sur les fonctionnalités de l’appareil.
cbwoc
Taille, en octets, de la structure WAVEOUTCAPS .
Valeur retournée
Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
L’identificateur d’appareil spécifié est hors de portée. |
|
Aucun pilote de périphérique n’est présent. |
|
Impossible d’allouer ou de verrouiller la mémoire. |
Remarques
Utilisez la fonction waveOutGetNumDevs pour déterminer le nombre d’appareils de sortie audio de forme d’onde présents dans le système. Si la valeur spécifiée par le paramètre uDeviceID est un identificateur d’appareil, elle peut varier de zéro à un inférieur au nombre d’appareils présents. La constante WAVE_MAPPER peut également être utilisée comme identificateur d’appareil. Seuls les octets cbwoc (ou moins) d’informations sont copiés vers l’emplacement vers lequel pwoc pointe. Si cbwoc a la valeur zéro, rien n’est copié et la fonction retourne zéro.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mmeapi.h (inclure Windows.h) |
| Bibliothèque | Winmm.lib |
| DLL | Winmm.dll |