функция обратного вызова DXGKDDI_STARTDIRTYTRACKING (d3dkmddi.h)

Статья
02/06/2025

Функция KMD DxgkDdiStartDirtyTracking позволяет отслеживать грязные биты в указанном сегменте и заданном диапазоне адресов.

Синтаксис

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

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

Параметры

hAdapter

[in] Дескриптор для блока контекста, связанного с адаптером отображения. KMD ранее предоставил этот дескриптор для Dxgkrnl в параметр е вывода miniportDeviceContextDxgiDdiAddDevice.

hMemoryBasis

[in] Обработайте базу памяти, с которой начинается отслеживание грязных операций. KMD создал этот дескриптор в предыдущем вызове DxgkDdiCreateMemoryBasis.

Возвращаемое значение

DxgkDdiStartDirtyTracking возвращает STATUS_SUCCESS при успешном выполнении. В противном случае возвращается соответствующий код NTSTATUS.

Замечания

Драйвер должен убедиться, что отслеживание грязных данных включено для указанной базы памяти. Однако при грубой детализации (например, включение грязного отслеживания для всего адаптера или сегмента) является допустимым до тех пор, пока все невыполненные запросы учитываются.

Dxgkrnl может одновременно включить отслеживание грязных страниц в нескольких сегментах или диапазонах в этих сегментах.

Если отслеживание грязных данных включено, Dxgkrnl ожидает, что грязный битовый план будет инициализирован ко всем нулям (все страницы не изменены).

Дополнительные сведения см. в отслеживания грязных битов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2 (WDDM 3.2)
заголовка	d3dkmddi.h
IRQL	PASSIVE_LEVEL

См. также

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking

Поделиться через