DXGKDDI_QUERYADAPTERINFO回调函数 (d3dkmddi.h)

  • 项目

DxgkDdiQueryAdapterInfo 函数从图形适配器检索配置信息。

语法

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Microsoft DirectX 图形内核子系统提供了此句柄。

[in] pQueryAdapterInfo

指向 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 成员中接收一个专有缓冲区，该缓冲区填充用户模式显示驱动程序识别适配器所需的配置信息。

如果 DirectX 图形内核子系统 (Dxgkrnl.sys) 在 子系统调用 DxgkDdiQueryAdapterInfo 时指定 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

另请参阅

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb