DRV_QUERYDEVICEINTERFACESIZE-Funktion
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.
Anforderungen
Zielplattform |
Desktop |
Version |
Unterstützt in Den Betriebssystemen Microsoft Windows Me und Windows 2000 und höher. |
Header |
Mmddk.h (include Mmddk.h) |
Weitere Informationen
Abrufen eines Geräteschnittstellennamens