DRVM_MAPPER_PREFERRED_GET, fonction

Article
02/07/2024

Le message DRVM_MAPPER_PREFERRED_GET récupère l’ID de l’appareil audio 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_PREFERRED_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 préféré actuel. La fonction écrit la valeur (-1) si aucun appareil disponible n’est éligible en tant qu’appareil 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 (pour les appels waveInMessage et waveOutMessage uniquement) : 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, waveOutMessage et midiOutMessage . Lorsque l’appelant appelle ces fonctions avec le message DRVM_MAPPER_PREFERRED_GET, l’appelant doit d’abord spécifier l’ID d’appareil comme WAVE_MAPPER (pour waveInMessage ou waveOutMessage) ou MIDI_MAPPER (pour midiOutMessage), puis caster cette valeur en type de handle approprié. Pour les fonctions waveInMessage, waveOutMessage ou midiOutMessage , l’appelant doit convertir l’ID de l’appareil en un type de handle de type HWAVEIN, HWAVEOUT ou HMIDIOUT, 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é pour les fonctions audio en général, contrairement au message DRVM_MAPPER_CONSOLEVOICECOM_GET , qui détermine quel appareil est préféré spécifiquement pour les communications vocales.

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 préféré actuel et ne recherchent pas d’autres appareils disponibles si l’appareil préféré n’est pas disponible. Notez que la fonction midiOutMessage ne génère pas cet indicateur : l’API midiOut utilise toujours uniquement l’appareil préféré. L’indicateur généré par l’appel waveInMessage ou waveOutMessage s’applique à l’appareil préféré pour les API waveIn et waveOut , que l’appel soit effectué à waveInMessage ou waveOutMessage.

Les fonctions xxxMessage acceptent cette valeur à la place d’un handle d’appareil valide afin de permettre à une application de déterminer l’ID d’appareil par défaut sans avoir à ouvrir d’abord un appareil. Pour plus d’informations, consultez Accès à l’ID d’appareil préféré.

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)