DRV_QUERYDEVICEINTERFACESIZE-Funktion

Artikel
02/03/2024

Die DRV_QUERYDEVICEINTERFACESIZE Nachrichtenabfragen nach der Größe des Puffers, der für den Geräteschnittstellennamen erforderlich ist.

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_QUERYDEVICEINTERFACESIZE fest, wenn xxxMessage aufgerufen wird, um diese Gerätenachricht zu verarbeiten.
dwParam1
Zeiger auf die Puffergröße. Dieser Parameter verweist auf eine ULONG-Variable, in die die Funktion die erforderliche Puffergröße in Bytes schreibt. Die Größe enthält Speicherplatz für den Abbruch von NULL der Namenszeichenfolge. Die Größe ist null, wenn die Geräte-ID ein Gerät ohne Geräteschnittstelle identifiziert.
dwParam2
Nicht verwendet. Legen Sie diesen Parameter auf 0 (null) fest.

Rückgabewert

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

Hinweise

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 Vom System abgefangene Gerätenachrichten.

Die von dieser Nachricht abgerufene Puffergröße wird als Byteanzahl ausgedrückt. Es gibt die Größe des Puffers an, der für die Unicode-Zeichenfolge mit Null-Terminen erforderlich ist, die den Geräteschnittstellennamen enthält. Der Aufrufer ordnet einen Puffer der angegebenen Größe zu und verwendet die DRV_QUERYDEVICEINTERFACE Meldung, um die Namenszeichenfolge der Geräteschnittstelle abzurufen.

Weitere Informationen finden Sie unter Abrufen eines Geräteschnittstellennamens.