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

Статья
02/06/2025

Dxgkrnl вызывает DxgkDdiQueryDirtyBitData запрашивать копию данных грязного битового плана из драйвера минипорта в режиме ядра (KMD).

Синтаксис

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

Параметры

hAdapter

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

pArgs

[in/out] Указатель на DXGKARG_QUERYDIRTYBITDATA структуру, содержащую входные и выходные данные для запроса.

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

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

Замечания

Функция предоставляет основы памяти и потенциальные идентификаторы подрангов для запрошенной грязной информации. KMD должен записывать полученные данные в выходной буфер. DxgkDdiQueryDirtyBitData позволяет запрашивать все диапазоны базы памяти или один.

Когда память доступна, Dxgkrnl попытается ускорить эту операцию с помощью одного вызова для запроса всех необходимых данных одновременно. Однако в условиях низкой памяти может потребоваться переадресация хода выполнения с помощью буфера меньшего размера, что является лишь меньшим подмножеством базы памяти, отслеживаемой до вызова DdiStartDirtyTracking. Запрошенный диапазон грязных битпланов никогда не превысит активно отслеживаемый диапазон грязных.

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

Требования

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

См. также

DXGKARG_QUERYDIRTYBITDATA

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