通过

DXGKDDI_STOPDIRTYTRACKING回调函数 （d3dkmddi.h）

  • 项目

KMD 的 DxgkDdiStopDirtyTracking 函数禁用指定段和给定地址范围内的脏位跟踪。

语法

DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;

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

参数

hAdapter

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

hMemoryBasis

[in]用于停止跟踪脏作的内存基数。 KMD 在上一次调用 dxgkDdiCreateMemoryBasis中创建此句柄。

返回值

DxgkDdiStopDirtyTracking 成功后返回STATUS_SUCCESS。 否则，它将返回适当的 NTSTATUS 代码。

言论

驱动程序应确保仍遵循以前的所有启动请求。 例如，如果 KMD 一次仅支持对整个段进行脏跟踪，并且有两个未完成的脏跟踪请求，则只停止一个请求应为另一个请求启用脏位跟踪。

可以保证调用 DxgkDdiStopDirtyTracking 将指定与相应 DxgkDdiStartDirtyTracking 调用相同的内存范围。 例如，如果 Dxgkrnl 调用在段 1 的 [0， 1GB] 上启动脏跟踪，最终将生成调用来停止段 [0， 1GB） 范围内的脏跟踪。

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

要求

要求 价值
最低支持的客户端 Windows 11 版本 24H2 （WDDM 3.2）
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiCreateMemoryBasis

DxgkDdiStartDirtyTracking