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

Статья
02/06/2025

Структура DXGKARGCB_PINFRAMEBUFFERFORSAVE2 содержит сведения, используемые функцией обратного вызова DXGKCB_PINFRAMEBUFFERFORSAVE2 для закрепления всего буфера кадров одновременно.

Синтаксис

typedef struct _DXGKARGCB_PINFRAMEBUFFERFORSAVE2 {
  [in]  UINT     PhysicalAdapterIndex;
  [in]  SIZE_T   CommitSize;
  union {
    struct {
      UINT PreferContiguous : 1;
      UINT Reserved : 31;
    };
          UINT Value;
  } Flags;
  [out] DXGK_ADL *pAdl;
} DXGKARGCB_PINFRAMEBUFFERFORSAVE2;

Члены

[in] PhysicalAdapterIndex

Индекс физического адаптера.

[in] CommitSize

Размер в байтах, необходимый драйверу. Этот размер должен быть кратным PAGE_SIZE и должен быть меньше или равен максимальному размеру, указанному драйвером в структуре DXGK_FRAMEBUFFERSAVEAREA при вызове обратного вызова драйвера DxgkDdiQueryAdapterInfo с DXGKQAITYPE_FRAMEBUFFERSAVESIZE во время инициализации драйвера.

Flags

Flags.PreferContiguous

Указывает, что драйвер может использовать список дескрипторов адресов (ADL) в этом пути и предпочтительнее массива страниц. Если включена логическая перемажание, это может сэкономить большое количество памяти при выделении ADL на основе CommitSize. Этот флаг действует одинаково с тем же именованным флагом в DXGKARGCB_ALLOCATE_ADL при выделенииADL.

Flags.Reserved

Скрытный; должно быть равно нулю.

Flags.Value

Альтернативный способ доступа к битам флагов .

[out] pAdl

При успешном вызове DXGKCB_PINFRAMEBUFFERFORSAVE2указывает на структуру DXGK_ADL со списком страниц буфера кадра. Эти страницы гарантированно сопоставляются с IoMmu.