DXGKARGCB_PINFRAMEBUFFERFORSAVE2 structure (d3dkmddi.h)

Article
02/26/2024

La structure DXGKARGCB_PINFRAMEBUFFERFORSAVE2 contient les informations utilisées par la fonction de rappel DXGKCB_PINFRAMEBUFFERFORSAVE2 pour épingler une mémoire tampon de trame entière à la fois.

Syntaxe

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;

Membres

[in] PhysicalAdapterIndex

Index de l’adaptateur physique.

[in] CommitSize

Taille, en octets, dont le pilote a besoin pour épingler. Cette taille doit être un multiple de PAGE_SIZE et doit être inférieure ou égale à la taille maximale spécifiée par le pilote dans la structure DXGK_FRAMEBUFFERSAVEAREA lorsque le rappel DxgkDdiQueryAdapterInfo du pilote est appelé avec DXGKQAITYPE_FRAMEBUFFERSAVESIZE lors de l’initialisation du pilote.

Flags

Flags.PreferContiguous

Indique que le pilote peut utiliser une liste de descripteurs d’adresses contiguës (ADL) dans ce chemin et qu’il est préférable à un tableau de pages. Lorsque le remapping logique est activé, cela peut économiser une grande quantité de mémoire lors de l’allocation de l’ADL en fonction de CommitSize. Cet indicateur se comporte de façon identique à l’indicateur du même nom dans DXGKARGCB_ALLOCATE_ADL lors de l’allocation d’un adl.

Flags.Reserved

Réservés au; doit être défini sur zéro.

Flags.Value

Une autre façon d’accéder aux bits Flags .

[out] pAdl

Lors d’un appel réussi à DXGKCB_PINFRAMEBUFFERFORSAVE2, pointe vers la structure DXGK_ADL avec une liste de pages de la zone d’enregistrement de la mémoire tampon de trame. Il est garanti que ces pages soient mappées à l’IoMmu.