EngQueryDeviceAttribute 函数 (winddi.h)

EngQueryDeviceAttribute 函数允许驱动程序查询系统设备的特定属性。

语法

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

参数

[in] hdev

设备的句柄。 此参数是驱动程序的 DrvCompletePDEV 函数接收的 GDI 句柄。

[in] devAttr

指定 GDI 应为其返回信息的属性。 此参数必须是QDA_ACCELERATION_LEVEL，用于查询 GDI 当前允许的驱动程序加速。

[in] pvIn

预留给系统使用。 GDI 当前忽略此参数。

[in] ulInSize

预留给系统使用。 GDI 当前忽略此参数。

[out] pvOut

指向 ulOutSize 字节缓冲区的指针，GDI 在其中写入有关要查询的属性的信息。 QDA_ACCELERATION_LEVEL devAttr 时，GDI 在缓冲区中写入 0 到 5 的 DWORD 值，指示当前加速级别。 有关加速级别的说明，请参阅 显示驱动程序测试工具 。

[out] ulOutSize

指定 pvOut 指向的缓冲区的大小（以字节为单位）。

返回值

EngQueryDeviceAttribute 在成功时返回 TRUE ;否则，它将返回 FALSE。

注解

可以通过 控制面板 中的显示程序动态设置视频卡的加速级别。 EngQueryDeviceAttribute 允许驱动程序确定当前设置的加速级别。

要求

要求	值
最低受支持的客户端	适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

另请参阅

DrvNotify