waveOutGetDevCapsA, fonction (mmeapi.h)

La fonction waveOutGetDevCapsA récupère les fonctionnalités d’un appareil de sortie audio waveform-audio donné. Il s’agit de la version ANSI de la fonction.

Syntaxe

MMRESULT waveOutGetDevCapsA(
  UINT_PTR       uDeviceID,
  LPWAVEOUTCAPSA pwoc,
  UINT           cbwoc
);

Paramètres

uDeviceID

Identificateur de l’appareil de sortie audio waveform-audio. Il peut s’agir d’un identificateur d’appareil ou d’un handle d’un périphérique de sortie audio de forme d’onde ouverte.

pwoc

Pointeur vers une structure WAVEOUTCAPSA à remplir avec des informations sur les fonctionnalités de l’appareil.

cbwoc

Taille, en octets, de la structure WAVEOUTCAPSA .

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou d’erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour	Descriptif
MMSYSERR_BADDEVICEID	L’identificateur d’appareil spécifié est hors limites.
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 waveform-audio 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 à une valeur inférieure 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 pointe pwoc. Si cbwoc est égal à zéro, rien n’est copié et la fonction retourne zéro.

Spécifications

Requirement	Valeur
Client minimum requis	Windows 2000 Professionnel
Serveur minimal pris en charge	Windows 2000 Server
Header	mmeapi.h
Library	Winmm.lib
DLL	Winmm.dll

Voir aussi

Audio de forme d’onde

Fonctions waveform