fonction waveOutGetDevCaps (mmeapi.h)

  • Article

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
MMSYSERR_BADDEVICEID
 L’identificateur d’appareil spécifié est hors de portée.
MMSYSERR_NODRIVER
 Aucun pilote de périphérique n’est présent.
MMSYSERR_NOMEM
 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

Voir aussi

Audio de forme d’onde

Fonctions de forme d’onde