funzione DRVM_MAPPER_PREFERRED_GET

Articolo
03/08/2023

Il messaggio DRVM_MAPPER_PREFERRED_GET recupera l'ID dispositivo del dispositivo preferito.

Sintassi

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

Parametri

uDeviceID
Specifica l'ID del dispositivo di destinazione. Per altre informazioni su come eseguire il cast di questo valore per l'uso con la funzione appropriata, vedere la sezione Osservazioni seguenti.
Umsg
Il chiamante imposta questo parametro su DRVM_MAPPER_PREFERRED_GET quando chiama xxxMessage per elaborare il messaggio del dispositivo.
dwParam1
Puntatore all'ID dispositivo. Questo parametro punta a una variabile DWORD in cui la funzione scrive l'ID dispositivo del dispositivo preferito corrente. La funzione scrive il valore (-1) se nessun dispositivo è disponibile che qualifica come dispositivo preferito.
dwParam2
Puntatore ai flag di stato. Questo parametro punta a una variabile DWORD in cui la funzione scrive i flag di stato del dispositivo. È attualmente definito un solo bit di flag (solo per le chiamate waveInMessage e waveOutMessage ): DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

La funzione xxxMessage restituisce MMSYSERR_NOERROR se il messaggio viene gestito correttamente. In caso contrario, restituisce un codice di errore appropriato.

Commenti

Questo messaggio è valido solo per le funzioni waveInMessage, waveOutMessage e midiOutMessage. Quando il chiamante chiama queste funzioni con il messaggio DRVM_MAPPER_PREFERRED_GET, il chiamante deve prima specificare l'ID dispositivo come WAVE_MAPPER (per waveInMessage o waveOutMessage) o MIDI_MAPPER (per midiOutMessage) e quindi eseguire il cast di questo valore al tipo di handle appropriato. Per le funzioni waveInMessage, waveOutMessage o midiOutMessage, il chiamante deve eseguire rispettivamente il cast dell'ID dispositivo in un tipo di handle HWAVEIN, HWAVEOUT o HMIDIOUT. Si noti che se il chiamante fornisce un handle valido anziché un ID dispositivo per questo parametro, la funzione ha esito negativo e restituisce il codice di errore MMSYSERR_NOSUPPORT.

Il sistema intercetta questo messaggio e restituisce il valore appropriato senza inviare il messaggio al driver del dispositivo. Per informazioni generali sulle funzioni xxxMessage intercettate dal sistema, vedere Messaggi del dispositivo intercettati dal sistema.

Questo messaggio consente di determinare quale dispositivo è preferito per le funzioni audio in generale, a differenza del messaggio DRVM_MAPPER_CONSOLEVOICECOM_GET , che determina quale dispositivo è preferito specificamente per le comunicazioni vocali.

Quando il bit di flag DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY è impostato nella posizione DWORD a cui punta dwParam2, le API waveIn e waveOut usano solo il dispositivo preferito corrente e non cercare altri dispositivi disponibili se il dispositivo preferito non è disponibile. Si noti che la funzione midiOutMessage non restituisce questo flag: l'API midiOut usa sempre solo il dispositivo preferito. Il flag restituito dalla chiamata waveInMessage o waveOutMessage si applica al dispositivo preferito per le API waveIn ewaveOut, indipendentemente dal fatto che la chiamata venga effettuata a waveInMessage o waveOutMessage.

Le funzioni xxxMessage accettano questo valore al posto di un handle di dispositivo valido per consentire a un'applicazione di determinare l'ID dispositivo predefinito senza dover prima aprire un dispositivo. Per altre informazioni, vedere Accesso all'ID dispositivo preferito.

Requisiti

Piattaforma di destinazione	Desktop
Versione	Supportato in Microsoft Windows Me e Windows 2000 e nei sistemi operativi successivi.
Intestazione	Mmddk.h (include Mmddk.h)