DXGKARGCB_PINFRAMEBUFFERFORSAVE2 Struktur (d3dkmddi.h)

Artikel
02/06/2025

Die DXGKARGCB_PINFRAMEBUFFERFORSAVE2 Struktur enthält die Informationen, die von der DXGKCB_PINFRAMEBUFFERFORSAVE2 Rückruffunktion verwendet werden, um einen gesamten Framepuffer gleichzeitig anzuheften.

Syntax

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;

Angehörige

[in] PhysicalAdapterIndex

Der Index des physischen Adapters.

[in] CommitSize

Die Größe in Byte, die der Treiber zum Anheften benötigt. Diese Größe muss ein Vielfaches von PAGE_SIZE sein und muss kleiner oder gleich der vom Treiber in der DXGK_FRAMEBUFFERSAVEAREA Struktur angegebenen maximalen Größe sein, wenn die DxgkDdiQueryAdapterInfo Rückruf mit DXGKQAITYPE_FRAMEBUFFERSAVESIZE während der Treiberinitialisierung aufgerufen wird.

Flags

Flags.PreferContiguous

Gibt an, dass der Treiber eine zusammenhängende Adressdeskriptorliste (ADL) in diesem Pfad verwenden kann und einem Seitenarray vorzuziehen ist. Wenn die logische Neuzuordnung aktiviert ist, kann dies beim Zuordnen der ADL basierend auf CommitSize eine große Menge an Arbeitsspeicher sparen. Dieses Kennzeichen verhält sich in DXGKARGCB_ALLOCATE_ADL identisch mit dem flag mit demselben Namen, wenn eine ADL-zuordnen.

Flags.Reserved

Reserviert; muss auf Null festgelegt werden.

Flags.Value

Eine alternative Möglichkeit, auf die Flags Bits zuzugreifen.

[out] pAdl

Zeigt bei einem erfolgreichen Aufruf von DXGKCB_PINFRAMEBUFFERFORSAVE2auf die DXGK_ADL Struktur mit einer Liste der Seiten des Framepufferspeicherbereichs. Diese Seiten werden garantiert dem IoMmu zugeordnet.