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

Статья
05/23/2024

DXGKARG_QUERYDIRTYBITDATA — это параметр ввода и вывода, используемый dxgkDdiQueryDirtyBitData для запроса данных грязное bitplane.

Синтаксис

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 значений , определяющих дополнительное поведение для вызова.