DRV_QUERYDEVICEINTERFACE-Funktion

Artikel
03/08/2023

Die DRV_QUERYDEVICEINTERFACE Nachrichtenabfragen nach dem Geräteschnittstellennamen eines waveIn-, waveOut-, midiIn-, midiOut- oder Mixer-Geräts .

Syntax

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

Parameter

uDeviceID
Gibt die ID des Zielgeräts an.
uMsg
Der Aufrufer legt diesen Parameter auf DRV_QUERYDEVICEINTERFACE fest, wenn er xxxMessage aufruft, um diese Gerätenachricht zu verarbeiten.
dwParam1
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in den die Funktion eine Unicode-Zeichenfolge mit Null-Endung schreibt, die den Geräteschnittstellennamen enthält. Wenn das Gerät über keine Geräteschnittstelle verfügt, ist die Zeichenfolgenlänge 0.
dwParam2
Gibt die Puffergröße in Bytes an. Dies ist ein Eingabeparameter für die Funktion. Der Aufrufer sollte eine Größe angeben, die größer oder gleich der Puffergröße ist, die von der DRV_QUERYDEVICEINTERFACESIZE Nachricht abgerufen wird.

Rückgabewert

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

Hinweise

Die DRV_QUERYDEVICEINTERFACE Nachricht wird in Windows Me und Windows 2000 und höher unterstützt. Diese Nachricht ist nur für die Funktionen waveInMessage, waveOutMessage, midiInMessage, midiOutMessage und mixerMessage gültig. 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.

Die folgenden beiden Nachrichtenkonstanten werden zusammen zum Abrufen von Geräteschnittstellennamen verwendet:

DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE

Die erste Nachricht erhält die Größe des Puffers in Bytes, die erforderlich ist, um die Zeichenfolge mit dem Namen der Geräteschnittstelle zu enthalten. Die zweite Nachricht ruft die Namenszeichenfolge in einem Puffer der erforderlichen Größe ab.

Weitere Informationen finden Sie unter Abrufen eines Geräteschnittstellennamens.