fonction waveInOpen (mmeapi.h)

Article
08/24/2023

La fonction waveInOpen ouvre le périphérique d’entrée audio de forme d’onde donné pour l’enregistrement.

Syntaxe

MMRESULT waveInOpen(
  LPHWAVEIN       phwi,
  UINT            uDeviceID,
  LPCWAVEFORMATEX pwfx,
  DWORD_PTR       dwCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwOpen
);

Paramètres

phwi

Pointeur vers une mémoire tampon qui reçoit un handle identifiant le périphérique d’entrée audio de forme d’onde ouverte. Utilisez ce handle pour identifier l’appareil lors de l’appel d’autres fonctions d’entrée audio de forme d’onde. Ce paramètre peut avoir la valeur NULL si WAVE_FORMAT_QUERY est spécifié pour fdwOpen.

uDeviceID

Identificateur du périphérique d’entrée audio de forme d’onde à ouvrir. Il peut s’agir d’un identificateur d’appareil ou d’une poignée d’un périphérique d’entrée audio de forme d’onde ouverte. Vous pouvez utiliser l’indicateur suivant au lieu d’un identificateur d’appareil.

Valeur	Signification
WAVE_MAPPER	La fonction sélectionne un périphérique d’entrée audio de forme d’onde capable d’enregistrer dans le format spécifié.

pwfx

Pointeur vers une structure WAVEFORMATEX qui identifie le format souhaité pour l’enregistrement des données audio de forme d’onde. Vous pouvez libérer cette structure immédiatement après le retour de waveInOpen .

dwCallback

Pointeur vers une fonction de rappel fixe, un handle d’événement, un handle vers une fenêtre ou l’identificateur d’un thread à appeler pendant l’enregistrement audio de forme d’onde pour traiter les messages liés à la progression de l’enregistrement. Si aucune fonction de rappel n’est requise, cette valeur peut être égale à zéro. Pour plus d’informations sur la fonction de rappel, consultez waveInProc.

dwInstance

Les données instance l’utilisateur transmises au mécanisme de rappel. Ce paramètre n’est pas utilisé avec le mécanisme de rappel de fenêtre.

fdwOpen

Indicateurs d’ouverture de l’appareil. Les valeurs suivantes sont définies.

Valeur	Signification
CALLBACK_EVENT	Le paramètre dwCallback est un handle d’événement.
CALLBACK_FUNCTION	Le paramètre dwCallback est une adresse de procédure de rappel.
CALLBACK_NULL	Aucun mécanisme de rappel. Il s'agit du paramètre par défaut.
CALLBACK_THREAD	Le paramètre dwCallback est un identificateur de thread.
CALLBACK_WINDOW	Le paramètre dwCallback est un handle de fenêtre.
WAVE_MAPPED_DEFAULT_COMMUNICATION_DEVICE	Si cet indicateur est spécifié et que le paramètre uDeviceID est WAVE_MAPPER, la fonction ouvre le périphérique de communication par défaut. Cet indicateur s’applique uniquement lorsque uDeviceID est égal à WAVE_MAPPER. Note Nécessite Windows 7
WAVE_FORMAT_DIRECT	Si cet indicateur est spécifié, le pilote ACM n’effectue pas de conversions sur les données audio.
WAVE_FORMAT_QUERY	La fonction interroge l’appareil pour déterminer s’il prend en charge le format donné, mais elle n’ouvre pas l’appareil.
WAVE_MAPPED	Le paramètre uDeviceID spécifie un appareil audio de forme d’onde à mapper par le mappeur d’ondes.

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_ALLOCATED	La ressource spécifiée est déjà allouée.
MMSYSERR_BADDEVICEID	L’identificateur d’appareil spécifié est hors de portée.
MMSYSERR_NODRIVER	Aucun pilote de périphérique n’est présent.
MMSYSERR_NOMEM	Impossible d’allouer ou de verrouiller la mémoire.
WAVERR_BADFORMAT	Tentative d’ouverture avec un format audio de forme d’onde non pris en charge.

Notes

Utilisez la fonction waveInGetNumDevs pour déterminer le nombre de périphériques d’entrée audio de forme d’onde présents sur le système. L’identificateur d’appareil spécifié par uDeviceID varie de zéro à un inférieur au nombre d’appareils présents. La constante WAVE_MAPPER peut également être utilisée comme identificateur d’appareil.

Si vous choisissez de faire en sorte qu’une fenêtre ou un thread reçoive des informations de rappel, les messages suivants sont envoyés à la procédure de fenêtre ou au thread pour indiquer la progression de l’entrée audio de forme d’onde : MM_WIM_OPEN, MM_WIM_CLOSE et MM_WIM_DATA.

Si vous choisissez de faire en sorte qu’une fonction reçoive des informations de rappel, les messages suivants sont envoyés à la fonction pour indiquer la progression de l’entrée audio de forme d’onde : WIM_OPEN, WIM_CLOSE et WIM_DATA.

Configuration requise


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

Audio de forme d’onde

Fonctions de forme d’onde