EngQueryDeviceAttribute-Funktion (winddi.h)

Die EngQueryDeviceAttribute-Funktion ermöglicht es dem Treiber, das System nach bestimmten Attributen des Geräts abzufragen.

Syntax

ENGAPI BOOL EngQueryDeviceAttribute(
  [in]  HDEV                 hdev,
  [in]  ENG_DEVICE_ATTRIBUTE devAttr,
  [in]  VOID                 *pvIn,
  [in]  ULONG                ulInSize,
  [out] VOID                 *pvOut,
  [out] ULONG                ulOutSize
);

Parameter

[in] hdev

Handle mit dem Gerät. Dieser Parameter ist das GDI-Handle, das von der DrvCompletePDEV-Funktion des Treibers empfangen wird.

[in] devAttr

Gibt das Attribut an, für das GDI Informationen zurückgeben soll. Dieser Parameter muss QDA_ACCELERATION_LEVEL sein, der die Treiberbeschleunigungen abfragt, die GDI derzeit zulässt.

[in] pvIn

Ist für das System reserviert. Dieser Parameter wird derzeit von GDI ignoriert.

[in] ulInSize

Ist für das System reserviert. Dieser Parameter wird derzeit von GDI ignoriert.

[out] pvOut

Zeiger auf einen Puffer von ulOutSize-Bytes , in dem GDI Informationen über das abgefragte Attribut schreibt. Wenn devAttr QDA_ACCELERATION_LEVEL ist, schreibt GDI in den Puffer einen DWORD-Wert von 0 bis 5, der den aktuellen Beschleunigungsgrad angibt. Eine Beschreibung der Beschleunigungsstufen finden Sie unter Anzeigen von Treibertesttools .

[out] ulOutSize

Gibt die Größe des Puffers in Bytes an, auf den pvOut verweist.

Rückgabewert

EngQueryDeviceAttribute gibt bei Erfolg TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Der Beschleunigungsgrad des Video-Karte kann dynamisch über das Programm Anzeige in Systemsteuerung festgelegt werden. EngQueryDeviceAttribute ermöglicht es dem Treiber, die derzeit festgelegte Beschleunigungsstufe zu bestimmen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

DrvNotify