DXGKDDI_STARTDIRTYTRACKING回调函数 (d3dkmddi.h)

KMD 的 DxgkDdiStartDirtyTracking 函数支持指定段和给定地址范围内脏位跟踪。

语法

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

NTSTATUS DxgkddiStartdirtytracking(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 KMD 以前在 DxgiDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Dxgkrnl 提供了此句柄。

hMemoryBasis

[in]用于开始跟踪脏操作的内存基础的句柄。 KMD 在上一次调用 DxgkDdiCreateMemoryBasis 时创建了此句柄。

返回值

DxgkDdiStartDirtyTracking 在成功时返回STATUS_SUCCESS。 否则,它将返回相应的 NTSTATUS 代码。

注解

驱动程序只需确保为指定的内存基础启用脏跟踪。 但是,以更粗糙的粒度 (执行此操作,例如,只要遵循所有未完成的请求,对整个适配器或段启用脏跟踪) 就有效。

Dxgkrnl 可以同时在这些段内的多个段或区域中启用脏页面跟踪。

启用脏跟踪后,Dxgkrnl 期望将脏位平面初始化为所有未修改) 的所有页面 (零。

有关详细信息,请参阅 脏位跟踪

要求

要求
最低受支持的客户端 Windows 11,版本 24H2 (WDDM 3.2)
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking