DRVM_MAPPER_CONSOLEVOICECOM_GET-Funktion

Artikel
06/15/2023

Die DRVM_MAPPER_CONSOLEVOICECOM_GET Nachricht ruft die Geräte-ID des bevorzugten Sprachkommunikationsgeräts ab.

Syntax

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

Parameter

uDeviceID
Gibt die ID des Zielgeräts an. Weitere Informationen zum Umwandeln dieses Werts für die Verwendung mit der entsprechenden Funktion finden Sie im abschnitt Hinweise .
uMsg
Der Aufrufer legt diesen Parameter auf DRVM_MAPPER_CONSOLEVOICECOM_GET fest, wenn er xxxMessage aufruft, um diese Gerätenachricht zu verarbeiten.
dwParam1
Zeiger auf geräte-ID. Dieser Parameter verweist auf eine DWORD-Variable, in die die Funktion die Geräte-ID des aktuell bevorzugten Sprachkommunikationsgeräts schreibt. Die Funktion schreibt den Wert (-1), wenn kein Gerät verfügbar ist, das als bevorzugtes Sprachkommunikationsgerät gilt.
dwParam2
Zeiger auf status Flags. Dieser Parameter verweist auf eine DWORD-Variable, in die die Funktion die Geräte-status-Flags schreibt. Derzeit ist nur ein Flagbit definiert: DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Die xxxMessage-Funktion gibt MMSYSERR_NOERROR zurück, wenn die Nachricht erfolgreich behandelt wird. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Hinweise

Diese Nachricht ist nur für die Funktionen waveInMessage und waveOutMessage gültig. Wenn ein Aufrufer diese beiden Funktionen mit der DRVM_MAPPER_CONSOLEVOICECOM_GET-Nachricht aufruft, muss der Aufrufer die Geräte-ID als WAVE_MAPPER angeben und diesen Wert dann in den entsprechenden Handle-Typ umwandeln. Für die Funktionen waveInMessage, waveOutMessage, midiInMessage, midiOutMessage oder mixerMessage muss der Aufrufer die Geräte-ID in einen Handle vom Typ HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT oder HMIXER umwandeln. Wenn der Aufrufer ein gültiges Handle anstelle einer Geräte-ID für diesen Parameter bereitstellt, schlägt die Funktion fehl und gibt den Fehlercode MMSYSERR_NOSUPPORT zurück.

Das System fängt diese Nachricht ab und gibt den entsprechenden Wert zurück, ohne die Nachricht an den Gerätetreiber zu senden. Allgemeine Informationen zu vom System abgefangenen xxxMessage-Funktionen finden Sie unter System-Intercepted Device Messages.

Diese Nachricht bietet eine Möglichkeit, zu bestimmen, welches Gerät speziell für die Sprachkommunikation bevorzugt wird, im Gegensatz zur DRVM_MAPPER_PREFERRED_GET Nachricht, die bestimmt, welches Gerät für alle anderen Audiofunktionen bevorzugt wird.

Beispielsweise kann das bevorzugte waveOut-Gerät für die Sprachkommunikation der Ohrhörer in einem Headset sein, aber das bevorzugte waveOut-Gerät für alle anderen Audiofunktionen kann eine Reihe von Stereolautsprechern sein.

Wenn das DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY Flagbits an der DWORD-Position festgelegt ist, auf die dwParam2 verweist, verwenden die waveIn - und waveOut-APIs nur das aktuell bevorzugte Sprachkommunikationsgerät und suchen nicht nach anderen verfügbaren Geräten, wenn das bevorzugte Gerät nicht verfügbar ist. Das Flag, das entweder vom waveInMessage - oder waveOutMessage-Aufruf ausgegeben wird, gilt für das bevorzugte Sprachkommunikationsgerät sowohl für die waveIn - als auch für die waveOutMessage-APIs , unabhängig davon, ob der Aufruf an waveInMessage oder waveOutMessage erfolgt. Weitere Informationen finden Sie unter Bevorzugte Voice-Communications Geräte-ID.