funzione DRVM_MAPPER_CONSOLEVOICECOM_GET

Articolo
02/03/2024

Il messaggio DRVM_MAPPER_CONSOLEVOICECOM_GET recupera l'ID dispositivo del dispositivo di comunicazione vocale 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_CONSOLEVOICECOM_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 di comunicazione vocale preferito corrente. La funzione scrive il valore (-1) se nessun dispositivo è disponibile che qualifica come dispositivo di comunicazione vocale 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: 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 e waveOutMessage . Quando un chiamante chiama queste due funzioni con il messaggio DRVM_MAPPER_CONSOLEVOICECOM_GET, il chiamante deve specificare l'ID dispositivo come WAVE_MAPPER e quindi eseguire il cast di questo valore al tipo di handle appropriato. Per le funzioni waveInMessage, waveOutMessage, midiInMessage, midiOutMessage o mixerMessage, il chiamante deve eseguire rispettivamente il cast dell'ID dispositivo in un handle di tipo HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT o HMIXER. 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 specificamente per le comunicazioni vocali, in contrasto con il messaggio DRVM_MAPPER_PREFERRED_GET , che determina quale dispositivo è preferito per tutte le altre funzioni audio.

Ad esempio, il dispositivo waveOut preferito per le comunicazioni vocali potrebbe essere l'orecchio in un visore visore, ma il dispositivo waveOut preferito per tutte le altre funzioni audio potrebbe essere un set di altoparlanti stereo.

Quando il bit di DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY flag viene impostato nella posizione DWORD a cui punta dwParam2, le API waveIn e waveOut usano solo il dispositivo di comunicazione vocale preferito corrente e non cercare altri dispositivi disponibili se il dispositivo preferito non è disponibile. Il flag che viene restituito dalla chiamata waveInMessage o waveOutMessage si applica al dispositivo di comunicazione vocale preferito per le API waveIn e waveOut, indipendentemente dal fatto che la chiamata venga effettuata a waveInMessage o waveOutMessage. Per altre informazioni, vedere Id dispositivo preferito Voice-Communications.

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)