waveInGetDevCapsA, fonction (mmeapi.h)

La fonction waveInGetDevCapsA récupère les fonctionnalités d’un périphérique d’entrée audio waveform-audio donné. Il s’agit de la version ANSI de cette fonction.

Syntaxe

MMRESULT waveInGetDevCapsA(
  UINT_PTR      uDeviceID,
  LPWAVEINCAPSA 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 WAVEINCAPSA à remplir avec des informations sur les fonctionnalités de l’appareil.

cbwic

Taille, en octets, de la structure WAVEINCAPSA .

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
Serveur minimal pris en charge	Windows 2000 Server
Header	mmeapi.h
Library	Winmm.lib
DLL	Winmm.dll