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

  • Статья

Структура 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.

Комментарии

Дополнительные сведения см. в статье Переназначение DMA IOMMU .

Требования

Требование Значение
Минимальная версия сервера Windows Server 2022 (WDDM 2.9)
Верхняя часть d3dkmddi.h

См. также раздел

DXGK_ADL

DXGK_FRAMEBUFFERSAVEAREA

DXGKCB_PINFRAMEBUFFERFORSAVE2

DxgkDdiQueryAdapterInfo