DXGKCB_CREATECONTEXTALLOCATION回调函数 (d3dkmddi.h)

项目
02/23/2024

DXGKCB_CREATECONTEXTALLOCATION 分配 GPU 上下文或特定于设备的上下文。

语法

DXGKCB_CREATECONTEXTALLOCATION DxgkcbCreatecontextallocation;

NTSTATUS DxgkcbCreatecontextallocation(
  [in/out] INOUT_PDXGKARGCB_CREATECONTEXTALLOCATION unnamedParam1
)
{...}

参数

[in/out] unnamedParam1

指向 DXGKARGCB_CREATECONTEXTALLOCATION 结构的指针，该结构指定要分配的上下文的属性。

返回值

如果成功，DXGKCB_CREATECONTEXTALLOCATION 将返回 STATUS_SUCCESS 。否则，它将返回 Ntstatus.h 中定义的错误代码之一。

注解

从 WDDM 1.2 开始，显示微型端口驱动程序可以分配特定于 GPU 的上下文 (GPU 上下文分配) 或特定于设备的上下文 (设备上下文分配) 。

GPU 上下文分配允许 GPU 存储执行期间被抢占的 DMA 缓冲区中的上下文状态。驱动程序创建与 GPU 上下文关联的分配，以在必要时保存其状态。操作系统确保在将来自此上下文的命令放入 GPU 的硬件执行队列之前，上下文分配处于驻留状态。上下文将保持驻留状态，直到来自另一个上下文的命令放置在硬件执行队列中。

此外，操作系统支持延迟 GPU 上下文切换，方法是在完成属于上下文的命令后，假定 GPU 上保留硬件上下文状态。这样，只有在将来自不同上下文的命令提交到硬件队列时，才会在 GPU 上切换上下文。

DXGKCB_XXX 函数由 Dxgkrnl 实现。若要使用此回调函数，请设置 DXGKARGCB_ALLOCATEPAGESFORMDL 的成员，然后通过 DXGKRNL_INTERFACE调用 DxgkCbCreateContextAllocation。

GPU 上下文分配

只能对非系统上下文进行 GPU 上下文分配。显示微型端口驱动程序通过调用 DxgkDdiCreateContext 来创建这些上下文。若要创建非系统上下文，驱动程序将 DXGK_CREATECONTEXTFLAGS 结构的 SystemContext 成员设置为零，并在 pCreateContext 参数中传递指向此结构的指针。

设备上下文分配遵循类似的模型，不同之处在于，对于属于其关联的设备的任何上下文，设备上下文分配将保持驻留状态。此模型允许驱动程序使用 GPU 上下文分配来存储 GPU 上下文保存区域 (CSA) 数据，并使用设备上下文分配来存储页表数据。

设备上下文分配

只能对非系统设备进行设备上下文分配。显示微型端口驱动程序通过调用 DxgkDdiCreateDevice 创建这些设备。若要创建非系统设备，驱动程序将 DXGK_CREATEDEVICEFLAGS 结构的 Flags.SystemDevice 成员设置为零，并在 pCreateDevice 参数中传递指向此结构的指针。

显示微型端口驱动程序调用 DXGKCB_DESTROYCONTEXTALLOCATION 以释放通过 DxgkCbCreateContextAllocation 分配的上下文资源。

目标上下文分配的虚拟地址

若要确保操作系统为目标上下文分配设置有效的 (非 NULL) 虚拟地址， (DXGKARG_BUILDPAGINGBUFFER 结构) 的 InitContextResource-Destination-VirtualAddress>> 成员，当显示微型端口驱动程序调用 DxgkCbCreateContextAllocation 时，它必须：

设置 DXGK_ALLOCATIONINFOFLAGS 结构的 CpuVisible 和 Protected 成员。
通过设置 DXGKARGCB_CREATECONTEXTALLOCATION 结构的SupportedSegmentSet 成员，仅向光圈段分配页面。

要求

要求	值
最低受支持的客户端	Windows 8 (WDDM 1.2)
最低受支持的服务器	Windows Server 2012
目标平台	桌面
标头	d3dkmddi.h (包括 D3dkmddi.h)
IRQL	PASSIVE_LEVEL