waveInGetDevCaps, fonction (mmeapi.h)

  • Article

La fonction waveInGetDevCaps récupère les fonctionnalités d’un périphérique d’entrée audio de forme d’onde donnée.

Syntaxe

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

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’un handle d’un périphérique d’entrée audio de forme d’onde ouverte.

pwic

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

cbwic

Taille, en octets, de la structure WAVEINCAPS .

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 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 cette fonction pour déterminer le nombre de périphériques d’entrée 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 de moins que le nombre d’appareils présents. La constante WAVE_MAPPER peut également être utilisée comme identificateur d’appareil. Seuls les octets cbwic (ou moins) des informations sont copiés à l’emplacement vers lequel pwic pointe. Si cbwic est égal à 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

Waveform Audio

Fonctions de forme d’onde