DRVM_MAPPER_PREFERRED_GET-Funktion

Artikel
02/07/2024

Die DRVM_MAPPER_PREFERRED_GET-Meldung ruft die Geräte-ID des bevorzugten Audiogerä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_PREFERRED_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 Geräts schreibt. Die Funktion schreibt den Wert (-1), wenn kein Gerät verfügbar ist, das als bevorzugtes Gerä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 (nur für waveInMessage - und waveOutMessage-Aufrufe ): 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, waveOutMessage und midiOutMessage gültig. Wenn der Aufrufer diese Funktionen mit der DRVM_MAPPER_PREFERRED_GET-Nachricht aufruft, muss der Aufrufer zuerst die Geräte-ID als WAVE_MAPPER (für waveInMessage oder waveOutMessage) oder MIDI_MAPPER (für midiOutMessage) angeben und diesen Wert dann in den entsprechenden Handle-Typ umwandeln. Für die Funktionen waveInMessage, waveOutMessage oder midiOutMessage muss der Aufrufer die Geräte-ID in einen Handle-Typ HWAVEIN, HWAVEOUT oder HMIDIOUT 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 für Audiofunktionen im Allgemeinen bevorzugt wird, im Gegensatz zur DRVM_MAPPER_CONSOLEVOICECOM_GET Nachricht, die bestimmt, welches Gerät speziell für die Sprachkommunikation bevorzugt wird.

Wenn das DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY Flagbit an der DWORD-Position festgelegt wird, auf die dwParam2 verweist, verwenden die waveIn - und waveOut-APIs nur das aktuell bevorzugte Gerät und suchen nicht nach anderen verfügbaren Geräten, wenn das bevorzugte Gerät nicht verfügbar ist. Beachten Sie, dass die midiOutMessage-Funktion dieses Flag nicht ausgibt. Die midiOut-API verwendet immer nur das bevorzugte Gerät. Das Flag, das entweder vom waveInMessage - oder waveOutMessage-Aufruf ausgegeben wird, gilt für das bevorzugte Gerät sowohl für die waveIn - als auch für die waveOut-APIs , unabhängig davon, ob der Aufruf an waveInMessage oder waveOutMessage erfolgt.

Die xxx-Nachrichtenfunktionenakzeptieren diesen Wert anstelle eines gültigen Gerätehandles, damit eine Anwendung die Standardgeräte-ID ermitteln kann, ohne zuvor ein Gerät öffnen zu müssen. Weitere Informationen finden Sie unter Zugreifen auf die bevorzugte Geräte-ID.