DrvQueryDriverInfo-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvQueryDriverInfo-Funktion gibt angeforderte treiberspezifische Informationen zurück.

Syntax

BOOL DrvQueryDriverInfo(
        DWORD  dwMode,
  [out] PVOID  pBuffer,
        DWORD  cbBuf,
  [out] PDWORD pcbNeeded
);

Parameter

dwMode

Vom Aufrufer bereitgestellter konstanter Wert, wie in der folgenden Tabelle angegeben.

Wert	Definition
DRVQUERY_USERMODE	Der Aufrufer fragt ab, ob der Treiber im Benutzermodus oder im Kernelmodus ausgeführt wird.

[out] pBuffer

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer zum Empfangen angeforderter Informationen. Die Funktion muss die folgenden Informationen bereitstellen:

dwMode Wert	Pbuffer Größe	Von DrvQueryDriverInfo bereitgestellter Wert
DRVQUERY_USERMODE	Ein DWORD	TRUE , wenn der Treiber im Benutzermodus ausgeführt wird; Andernfalls FALSE .

cbBuf

Vom Aufrufer bereitgestellter Wert, der die Größe des Puffers in Bytes darstellt, auf den pBuffer verweist.

[out] pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, um die minimale Puffergröße in Bytes zu erhalten, die erforderlich ist, um die angeforderten Informationen zu enthalten.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte FALSE zurückgegeben werden.

Hinweise

Druckergrafik-DLLs , die im Benutzermodus ausgeführt werden, müssen eine DrvQueryDriverInfo-Funktion exportieren. Wenn die Funktion nicht exportiert wird, geht der lokale Druckanbieter davon aus, dass die Grafik-DLL im Kernelmodus ausgeführt wird.

Anforderungen


Zielplattform	Desktop
Kopfzeile	winddi.h (einschließlich Winddi.h)

Freigeben über