DRVM_MAPPER_CONSOLEVOICECOM_GET, fonction

Article
06/15/2023

Le message DRVM_MAPPER_CONSOLEVOICECOM_GET récupère l’ID d’appareil de l’appareil de communication vocale préféré.

Syntaxe

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Paramètres

uDeviceID
Spécifie l’ID de l’appareil cible. Pour plus d’informations sur la conversion de cette valeur pour une utilisation avec la fonction appropriée, consultez la section Remarques suivante.
uMsg
L’appelant définit ce paramètre sur DRVM_MAPPER_CONSOLEVOICECOM_GET lorsqu’il appelle xxxMessage pour traiter ce message d’appareil.
dwParam1
Pointeur vers l’ID de l’appareil. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit l’ID d’appareil de l’appareil de communication vocale préféré actuel. La fonction écrit la valeur (-1) si aucun appareil disponible n’est éligible en tant qu’appareil de communication vocale préféré.
dwParam2
Pointeur vers status indicateurs. Ce paramètre pointe vers une variable DWORD dans laquelle la fonction écrit les indicateurs status appareil. Un seul bit d’indicateur est actuellement défini : DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

La fonction xxxMessage retourne MMSYSERR_NOERROR si le message est correctement géré. Sinon, elle retourne un code d’erreur approprié.

Remarques

Ce message est valide uniquement pour les fonctions waveInMessage et waveOutMessage . Lorsqu’un appelant appelle ces deux fonctions avec le message DRVM_MAPPER_CONSOLEVOICECOM_GET, l’appelant doit spécifier l’ID d’appareil comme WAVE_MAPPER, puis convertir cette valeur en type de handle approprié. Pour les fonctions waveInMessage, waveOutMessage, midiInMessage, midiOutMessage ou mixerMessage , l’appelant doit convertir l’ID de l’appareil en un handle de type HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT ou HMIXER, respectivement. Notez que si l’appelant fournit un handle valide au lieu d’un ID d’appareil pour ce paramètre, la fonction échoue et retourne le code d’erreur MMSYSERR_NOSUPPORT.

Le système intercepte ce message et retourne la valeur appropriée sans envoyer le message au pilote de périphérique. Pour obtenir des informations générales sur les fonctions xxxMessage interceptées par le système, consultez Messages d’appareil interceptés par le système.

Ce message permet de déterminer quel appareil est préféré spécifiquement pour les communications vocales, contrairement au message DRVM_MAPPER_PREFERRED_GET , qui détermine quel appareil est préféré pour toutes les autres fonctions audio.

Par exemple, l’appareil waveOut préféré pour les communications vocales peut être l’écouteur d’un casque, mais l’appareil waveOut préféré pour toutes les autres fonctions audio peut être un ensemble de haut-parleurs stéréo.

Lorsque le bit d’indicateur DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY est défini à l’emplacement DWORD pointé par dwParam2, les API waveIn et waveOut utilisent uniquement l’appareil de communication vocale préféré actuel et ne recherchent pas d’autres appareils disponibles si l’appareil préféré n’est pas disponible. L’indicateur qui est généré par l’appel waveInMessage ou waveOutMessage s’applique au périphérique de communication vocale préféré pour les API waveIn et waveOut , que l’appel soit effectué à waveInMessage ou waveOutMessage. Pour plus d’informations, consultez L’ID d’appareil préféré Voice-Communications.

Configuration requise

Plateforme cible	Desktop (Expérience utilisateur)
Version	Pris en charge dans Les systèmes d’exploitation Microsoft Windows Me et Windows 2000 et ultérieur.
En-tête	Mmddk.h (include Mmddk.h)