Accesso all'ID dispositivo preferito

Le funzioni multimediali di Windows waveInMessage, waveOutMessage e midiOutMessage possono recuperare l'ID dispositivo del dispositivo preferito. Queste tre funzioni ottengono gli ID dispositivo preferiti per l'input dell'onda, l'output delle onde e l'output MIDI, rispettivamente. Queste informazioni sono utili per i programmi dell'applicazione che, ad esempio, consentono agli utenti di selezionare un dispositivo da aprire da un elenco di due o più dispositivi. Tale applicazione deve in genere indicare quale tra i dispositivi nell'elenco è il dispositivo preferito.

Il dispositivo preferito è il dispositivo selezionato dall'utente tramite il pannello di controllo multimediale, mmsys.cpl. Se un'applicazione Multimediale o DirectSound di Windows non specifica in modo esplicito un dispositivo, il dispositivo preferito viene selezionato per impostazione predefinita.

Per recuperare l'ID dispositivo del dispositivo audio preferito corrente, un'applicazione chiama la funzione xxxMessage con il parametro message impostato sulla costante DRVM_MAPPER_PREFERRED_GET.

Quando si chiama la funzione waveInMessage, waveOutMessage o midiOutMessage con il messaggio DRVM_MAPPER_PREFERRED_GET, specificare il valore dell'handle del dispositivo come WAVE_MAPPER (per waveInMessage o waveOutMessage) o MIDI_MAPPER (per midiOutMessage) ed eseguire il cast di questo valore al tipo di handle appropriato: HWAVEIN, HWAVEOUT o HMIDIOUT. Le funzioni xxx Message accettano questo valore al posto di un handle di dispositivo valido in modo che un'applicazione possa eseguire una query per l'ID dispositivo predefinito senza dover prima aprire un dispositivo. Per altre informazioni sulle funzioni xxx Message, vedere Messaggi dispositivo intercettati dal sistema.

Il messaggio DRVM_MAPPER_PREFERRED_GET viene intercettato dal mapper per il dispositivo di destinazione (waveIn, waveOut o midiOut). Per informazioni sui mapper per dispositivi wave e MIDI, vedere la documentazione di Microsoft Windows SDK.