структура DXGKARG_QUERYDIRTYBITDATA (d3dkmddi.h)

Статья
02/06/2025

DXGKARG_QUERYDIRTYBITDATA — это параметр ввода и вывода для DxgkDdiQueryDirtyBitData для запроса грязных данных битового плана.

Синтаксис

typedef struct _DXGKARG_QUERYDIRTYBITDATA {
  HANDLE MemoryBasis;
  UINT64 SubrangeIndex;
  UINT64 SubrangeOffset;
  UINT64 SubrangeSize;
  PVOID  Buffer;
  SIZE_T BufferSize;
  UINT   Flags;
} DXGKARG_QUERYDIRTYBITDATA;

Члены

MemoryBasis

[in] Обработайте коллекцию диапазонов страниц физической памяти, чтобы запросить измененное состояние. Этот дескриптор ранее был создан вызовом DxgkDdiCreateMemoryBasis.

SubrangeIndex

[in] Если указан подранг (см. ниже SubrangeSize), эти данные представляют диапазон в базе памяти для запроса.

SubrangeOffset

[in] Если SubrangeSize не равно 0, SubrangeOffset представляет необязательное смещение в подранг, выбранный для запроса текущего грязного битового плана. Это значение является смещением в байтах и всегда является нескольким размером страницы битового плана.

SubrangeSize

[in] Задает диапазон базы памяти для запроса. Если subrangeSize равно 0, драйвер должен запрашивать всю базу памяти. При указании ненулевых размеров драйвер должен запрашивать один диапазон базы памяти, где SubrangeIndex и SubrangeOffset предоставить начальный индекс физического интервала для запроса. SubrangeSize находится в байтах и всегда является нескольким размером страницы битового плана.

Buffer

[out] Буфер, в котором записываются полученные данные битового плана.

BufferSize

[out] Размер буфера битового плоскости в байтах. Размер гарантированно должен быть достаточно большим, чтобы соответствовать одному биту на страницу в пределах указанного подранга, что по крайней мере Size/DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS::PageSize/8 (округлено) байтов. Если запрашивается один подранг, BufferSize представляет SubrangeSize, в то время как если указана ссылка на всю базу памяти, BufferSize — это сумма всех SizeInBytes диапазонов в основе.

Flags

[in] Одно или несколько DXGKARG_QUERYDIRTYBITDATAFLAGS значений, указывающих дополнительное поведение для вызова.

Замечания

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

Требования

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

См. также

DXGKARG_QUERYDIRTYBITDATAFLAGS

DxgkDdiCreateMemoryBasis

DxgkDdiQueryDirtyBitData

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