waveInGetDevCaps, fonction (mmeapi.h)
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 |
|---|---|
|
L’identificateur d’appareil spécifié est hors limites. |
|
Aucun pilote de périphérique n’est présent. |
|
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 |