функция обратного вызова DXGKDDI_QUERYDIRTYBITDATA (d3dkmddi.h)
Dxgkrnl вызывает DxgkDdiQueryDirtyBitData, чтобы запросить копию данных грязное bitplane из драйвера мини-порта в режиме ядра (KMD).
Синтаксис
DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;
NTSTATUS DxgkddiQuerydirtybitdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}
Параметры
hAdapter
[in] Дескриптор для блока контекста, связанного с видеоадаптером. Ранее KMD предоставлял этот дескриптор Dxgkrnl в выходном параметре MiniportDeviceContext функции DxgiDdiAddDevice .
pArgs
[вход/выход] Указатель на структуру DXGKARG_QUERYDIRTYBITDATA , содержащую входные и выходные сведения для запроса.
Возвращаемое значение
DxgkDdiQueryDirtyBitData возвращает STATUS_SUCCESS, если запрос выполнен успешно. В противном случае возвращается соответствующий код ошибки NTSTATUS.
Комментарии
Функция предоставляет базу памяти и потенциальные идентификаторы поддиапа для запрошенных сведений грязное. KMD должен записать полученные данные в выходной буфер. DxgkDdiQueryDirtyBitData позволяет запрашивать все диапазоны базисной памяти или один диапазон.
Когда память доступна, Dxgkrnl попытается ускорить эту операцию, используя один вызов для запроса всех необходимых данных одновременно. Однако в условиях нехватки памяти может потребоваться использовать буфер меньшего размера, который является лишь меньшим подмножеством базы памяти, отслеживаемой из предыдущего вызова DdiStartDirtyTracking. Запрошенный диапазон грязное битовой плоскости никогда не будет превышать активно отслеживаемый диапазон грязное.
Дополнительные сведения см. в разделе Отслеживание грязных битов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 11 версии 24H2 (WDDM 3.2) |
| Верхняя часть | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |