通过

DXGKDDI_QUERYADAPTERINFO回调函数 （d3dkmddi.h）

  • 项目

Dxgkrnl 调用显示微型端口驱动程序（KMD）DxgkDdiQueryAdapterInfo 函数，以从图形适配器检索配置信息。

语法

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

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

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 KMD 以前提供了此句柄，用于在 MiniportDeviceContextDxgkDdiAddDevice 函数的输出参数中 Dxgkrnl。

[in] pQueryAdapterInfo

指向 KMD 使用图形适配器的配置信息填充的 DXGKARG_QUERYADAPTERINFO 结构的指针。

返回值

DxgkDdiQueryAdapterInfo 成功检索配置信息时返回STATUS_SUCCESS。 否则，它将返回 NTSTATUS 代码，例如以下值之一：

返回代码 描述
STATUS_INVALID_PARAMETER 一个或多个传递的参数包含阻止其完成的错误。
STATUS_NO_MEMORY DxgkDdiQueryAdapterInfo 无法分配完成所需的内存。
STATUS_GRAPHICS_DRIVER_MISMATCH KMD 与发起调用 DxgkDdiQueryAdapterInfo（即为 KMD 查询提供的专用数据）的用户模式显示驱动程序（UMD）不兼容。

言论

当 UMD 调用 Direct3D 运行时的 pfnQueryAdapterInfoCb 回调时，将启动对 DxgkDdiQueryAdapterInfo 函数的调用。

  • 如果 Dxgkrnl 在 DXGKARG_QUERYADAPTERINFO：：Type中指定DXGKQAITYPE_UMDRIVERPRIVATE，pOutputData 指向 KMD 使用 UMD 标识适配器所需的配置信息填充的专有结构。

  • 如果 Dxgkrnl 在 DXGKARG_QUERYADAPTERINFO：：Type中指定DXGKQAITYPE_DRIVERCAPS，则 KMD 应使用子系统可以使用的信息填充所提供的 DXGK_DRIVERCAPS 结构。

  • 如果 Dxgkrnl 在 DXGKARG_QUERYADAPTERINFO：：Type中指定DXGKQAITYPE_QUERYSEGMENT，则 KMD 应提供有关它支持的内存段的信息。 有关内存段的详细信息，请参阅 初始化内存段。

应 DxgkDdiQueryAdapterInfo 进行分页。

支持 WDDM 2.6 及更高版本的所有驱动程序都必须实现 DxgkDdiQueryAdapterInfo 回调。

要求

要求 价值
最低支持的客户端 Windows Vista （WDDM 1.0）
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb