DXGKARGCB_PINFRAMEBUFFERFORSAVE2 struttura (d3dkmddi.h)

Articolo
02/26/2024

La struttura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 contiene le informazioni usate dalla funzione di callback DXGKCB_PINFRAMEBUFFERFORSAVE2 per aggiungere un intero buffer frame contemporaneamente.

Sintassi

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;

Members

[in] PhysicalAdapterIndex

Indice dell'adattatore fisico.

[in] CommitSize

Dimensioni, in byte, che il driver richiede di aggiungere. Questa dimensione deve essere un multiplo di PAGE_SIZE e deve essere minore o uguale alla dimensione massima specificata dal driver nella struttura DXGK_FRAMEBUFFERSAVEAREA quando il callback dxgkDdiQueryAdapterInfo del driver viene chiamato con DXGKQAITYPE_FRAMEBUFFERSAVESIZE durante l'inizializzazione del driver.

Flags

Flags.PreferContiguous

Indica che il driver può usare un elenco di descrittori di indirizzi contigui (ADL) in questo percorso ed è preferibile a una matrice di pagine. Quando è abilitato il mapping logico, questo può risparmiare una grande quantità di memoria durante l'allocazione di ADL in base a CommitSize. Questo flag si comporta in modo identico allo stesso flag denominato in DXGKARGCB_ALLOCATE_ADL quando si assegna un ADL.

Flags.Reserved

Riservati; deve essere impostato su zero.

Flags.Value

Un modo alternativo per accedere ai bit flag .

[out] pAdl

In una chiamata riuscita a DXGKCB_PINFRAMEBUFFERFORSAVE2, punta alla struttura DXGK_ADL con un elenco di pagine dell'area di salvataggio del buffer frame. Queste pagine devono essere mappate a IoMmu.