estructura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 (d3dkmddi.h)

Artículo
02/06/2025

La estructura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 contiene la información utilizada por la función de devolución de llamada DXGKCB_PINFRAMEBUFFERFORSAVE2 para anclar un búfer de fotogramas completo a la vez.

Sintaxis

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;

Miembros

[in] PhysicalAdapterIndex

Índice del adaptador físico.

[in] CommitSize

Tamaño, en bytes, que el controlador necesita anclar. Este tamaño debe ser un múltiplo de PAGE_SIZE y debe ser menor o igual que el tamaño máximo especificado por el controlador en la estructura de DXGK_FRAMEBUFFERSAVEAREA cuando se llama a dxgkDdiQueryAdapterInfo del controladordevolución de llamada con DXGKQAITYPE_FRAMEBUFFERSAVESIZE durante la inicialización delcontrolador.

Flags

Flags.PreferContiguous

Indica que el controlador puede usar una lista de descriptores de direcciones contiguos (ADL) en esta ruta de acceso y es preferible a una matriz de páginas. Cuando la reasignación lógica está habilitada, esto puede ahorrar una gran cantidad de memoria al asignar el ADL basado en CommitSize. Esta marca se comporta de forma idéntica a la marca con el mismo nombre en DXGKARGCB_ALLOCATE_ADL cuando asignar unde ADL.

Flags.Reserved

Reservado; debe establecerse en cero.

Flags.Value

Una manera alternativa de acceder a los bits de Flags.

[out] pAdl

En una llamada correcta a DXGKCB_PINFRAMEBUFFERFORSAVE2, apunta a la estructura DXGK_ADL con una lista de páginas del área de guardado del búfer de fotogramas. Se garantiza que estas páginas se asignen a IoMmu.