DXGKDDI_QUERYADAPTERINFO回调函数 (d3dkmddi.h)
显示微型端口 (KMD 的) DxgkDdiQueryAdapterInfo 函数从图形适配器检索配置信息。
语法
DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;
NTSTATUS DxgkddiQueryadapterinfo(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}
参数
[in] hAdapter
与显示适配器关联的上下文块的句柄。 KMD 之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Dxgkrnl 提供了此句柄。
[in] pQueryAdapterInfo
指向 KMD 使用图形适配器的配置信息填充的DXGKARG_QUERYADAPTERINFO结构的指针。
返回值
DxgkDdiQueryAdapterInfo 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | DxgkDdiQueryAdapterInfo 已成功检索配置信息。 |
| STATUS_INVALID_PARAMETER | 传递给 DxgkDdiQueryAdapterInfo 的参数包含阻止其完成的错误。 |
| STATUS_NO_MEMORY | DxgkDdiQueryAdapterInfo 无法分配完成它所需的内存。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 显示微型端口驱动程序与启动对 DxgkDdiQueryAdapterInfo (调用的用户模式显示驱动程序不兼容，即为显示微型端口驱动程序) 的查询提供了专用数据。 |
注解
当用户模式显示驱动程序调用 pfnQueryAdapterInfoCb 函数时，将启动对 DxgkDdiQueryAdapterInfo 函数的调用。
如果 DxgkDdiQueryAdapterInfo 在 pQueryAdapterInfo 参数指向的 DXGKARG_QUERYADAPTERINFO 结构的 Type 成员中收到DXGKQAITYPE_UMDRIVERPRIVATE值，则 pOutputData 指向 KMD 用用户模式显示驱动程序标识适配器所需的配置信息填充的专有结构。
如果当子系统调用 DxgkDdiQueryAdapterInfo 时， Dxgkrnl 在 DXGKARG_QUERYADAPTERINFO 的 Type 成员中指定 DXGKQAITYPE_DRIVERCAPS值，则显示微型端口驱动程序应使用子系统可以使用的信息填充所提供的 DXGK_DRIVERCAPS 结构。
如果 DirectX 图形内核子系统在 DXGKARG_QUERYADAPTERINFO 的 Type 成员中提供DXGKQAITYPE_QUERYSEGMENT值，则显示微型端口驱动程序应提供有关其支持的内存段的信息。 有关内存段的详细信息，请参阅 初始化内存段的使用。
应使 DxgkDdiQueryAdapterInfo 可分页。
支持 WDDM 2.6 及更高版本的所有驱动程序都必须实现 DxgkDdiQueryAdapterInfo 回调。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |