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

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

Синтаксис

DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;

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

Параметры

hAdapter

[in] Дескриптор для блока контекста, связанного с видеоадаптером. KMD ранее предоставлял этот дескриптор Dxgkrnl в выходном параметре MiniportDeviceContext функции DxgiDdiAddDevice .

hMemoryBasis

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

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

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

Комментарии

Драйвер должен убедиться, что все предыдущие запросы на запуск по-прежнему выполняются. Например, если KMD поддерживает только отслеживание грязное во всем сегменте одновременно и есть два невыполненных запроса для отслеживания грязное, при остановке только одного запроса должно быть включено грязное битовое отслеживание для другого запроса.

Драйвер может гарантировать, что вызов DxgkDdiStopDirtyTracking будет указывать те же диапазоны памяти, что и соответствующие вызовы DxgkDdiStartDirtyTracking . Например, если Dxgkrnl сделал вызов для запуска грязное отслеживания на [0, 1 ГБ) сегмента 1, в конечном итоге будет получен вызов для остановки отслеживания грязное в диапазоне сегмента [0, 1 ГБ) в сегменте 1.

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

Требования

См. также раздел

DxgkDdiCreateMemoryBasis

DxgkDdiStartDirtyTracking