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

DRV_QUERYDEVICEINTERFACE

midiInMessage

midiOutMessage

mixerMessage

Abrufen eines Geräteschnittstellennamens

Vom System abgefangene Gerätenachrichten

waveInMessage

waveOutMessage