Partager via


waveInGetDevCaps, fonction (mmeapi.h)

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

Syntaxe

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

Paramètres

uDeviceID

Identificateur de l’appareil d’entrée audio de forme d’onde. Il peut s’agir d’un identificateur d’appareil ou d’un handle d’un appareil 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 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 cette fonction pour déterminer le nombre d’appareils 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 à 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 cbwic (ou moins) d’informations sont copiés vers l’emplacement vers lequel pointe pwic. Si cbwic 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

Fonctions Waveform AudioWaveform