struktur DXGKARGCB_PINFRAMEBUFFERFORSAVE2 (d3dkmddi.h)

Artikel
08/07/2023

Struktur DXGKARGCB_PINFRAMEBUFFERFORSAVE2 berisi informasi yang digunakan oleh fungsi panggilan balik DXGKCB_PINFRAMEBUFFERFORSAVE2 untuk menyematkan seluruh buffer bingkai sekaligus.

Sintaks

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;

Anggota

[in] PhysicalAdapterIndex

Indeks adaptor fisik.

[in] CommitSize

Ukuran, dalam byte, yang diperlukan driver untuk menyematkan. Ukuran ini harus berupa kelipatan PAGE_SIZE dan harus kurang dari atau sama dengan ukuran maksimum yang ditentukan oleh driver dalam struktur DXGK_FRAMEBUFFERSAVEAREA ketika panggilan balik DxgkDdiQueryAdapterInfo driver dipanggil dengan DXGKQAITYPE_FRAMEBUFFERSAVESIZE selama inisialisasi driver.

Flags

Flags.PreferContiguous

Menunjukkan bahwa driver dapat menggunakan daftar deskriptor alamat (ADL) yang berdekatan di jalur ini dan lebih disukai daripada array halaman. Saat remapping logis diaktifkan, ini dapat menghemat sejumlah besar memori saat mengalokasikan ADL berdasarkan CommitSize. Bendera ini berperilaku identik dengan bendera bernama sama di DXGKARGCB_ALLOCATE_ADL saat mengalokasikan ADL.

Flags.Reserved

Dipesan; harus diatur ke nol.

Flags.Value

Cara alternatif untuk mengakses bit Bendera .

[out] pAdl

Pada panggilan yang berhasil ke DXGKCB_PINFRAMEBUFFERFORSAVE2, menunjuk ke struktur DXGK_ADL dengan daftar halaman area penyimpanan buffer bingkai. Halaman-halaman ini dijamin akan dipetakan ke IoMmu.