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 |