Partager via


waveOutGetDevCaps, fonction (mmeapi.h)

La fonction waveOutGetDevCaps récupère les fonctionnalités d’un appareil de sortie audio waveform-audio donné.

Syntaxe

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS 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 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 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 [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Fenêtres
Header mmeapi.h (include Windows.h)
Library Winmm.lib
DLL Winmm.dll

Voir aussi

Audio de forme d’onde

Fonctions waveform