Accès à l’ID d’appareil préféré

Les fonctions multimédias Windows waveInMessage, waveOutMessage et midiOutMessage peuvent récupérer l’ID d’appareil de l’appareil préféré. Ces trois fonctions obtiennent les ID d’appareil préférés pour l’entrée d’onde, la sortie d’onde et la sortie MIDI, respectivement. Ces informations sont utiles pour les programmes d’application qui, par exemple, permettent aux utilisateurs de sélectionner un appareil à ouvrir dans une liste de deux appareils ou plus. Une telle application doit généralement indiquer l’appareil préféré parmi les appareils de la liste.

L’appareil préféré est l’appareil que l’utilisateur sélectionne via le panneau de configuration multimédia, mmsys.cpl. Si une application multimédia windows ou DirectSound ne spécifie pas explicitement d’appareil, l’appareil préféré est sélectionné par défaut.

Pour récupérer l’ID de l’appareil audio préféré actuel, une application appelle la fonction xxxMessage avec le paramètre message défini sur la constante DRVM_MAPPER_PREFERRED_GET.

Lorsque vous appelez la fonction waveInMessage, waveOutMessage ou midiOutMessage avec le message DRVM_MAPPER_PREFERRED_GET, spécifiez la valeur du handle d’appareil en tant que WAVE_MAPPER (pour waveInMessage ou waveOutMessage) ou MIDI_MAPPER (pour midiOutMessage) et castez cette valeur en type de handle approprié : HWAVEIN, HWAVEOUT ou HMIDIOUT. Les fonctions xxxMessage acceptent cette valeur à la place d’un handle d’appareil valide afin qu’une application puisse interroger l’ID d’appareil par défaut sans avoir à ouvrir d’abord un appareil. Pour plus d’informations sur les fonctions xxxMessage , consultez Messages d’appareil interceptés par le système.

Le message DRVM_MAPPER_PREFERRED_GET est intercepté par le mappeur pour l’appareil cible (waveIn, waveOut ou midiOut). Pour plus d’informations sur les mappeurs pour les appareils wave et MIDI, consultez la documentation Microsoft Windows SDK.