DXGKARGCB_PINFRAMEBUFFERFORSAVE2 Struktur (d3dkmddi.h)

Artikel
02/23/2024

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;

Member

[in] PhysicalAdapterIndex

Der Index des physischen Adapters.

[in] CommitSize

Die Größe in Bytes, die der Treiber zum Anheften benötigt. Diese Größe muss ein Vielfaches von PAGE_SIZE sein und muss kleiner oder gleich der maximalen Größe sein, die vom Treiber in der DXGK_FRAMEBUFFERSAVEAREA-Struktur angegeben wird, wenn der DxgkDdiQueryAdapterInfo-Rückruf des Treibers 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 Zuweisen der ADL basierend auf CommitSize eine große Menge an Arbeitsspeicher sparen. Dieses Flag verhält sich beim Zuweisen einer ADL identisch mit dem flag mit demselben Namen in DXGKARGCB_ALLOCATE_ADL.

Flags.Reserved

Reserviert; muss auf 0 festgelegt werden.

Flags.Value

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

[out] pAdl

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