DXGKARGCB_PINFRAMEBUFFERFORSAVE2 结构 (d3dkmddi.h)

项目
02/23/2024

DXGKARGCB_PINFRAMEBUFFERFORSAVE2 结构包含DXGKCB_PINFRAMEBUFFERFORSAVE2回调函数用于同时固定整个帧缓冲区的信息。

语法

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;

成员

[in] PhysicalAdapterIndex

物理适配器的索引。

[in] CommitSize

驱动程序需要固定的大小（以字节为单位）。此大小必须是PAGE_SIZE的倍数，并且必须小于或等于在驱动程序初始化期间使用DXGKQAITYPE_FRAMEBUFFERSAVESIZE调用驱动程序的 DxgkDdiQueryAdapterInfo 回调时驱动程序在 DXGK_FRAMEBUFFERSAVEAREA 结构中指定的最大大小。

Flags

Flags.PreferContiguous

指示驱动程序可以使用此路径中的连续地址描述符列表 (ADL) ，并且优于页数组。启用逻辑重新映射后，在基于 CommitSize 分配 ADL 时，这可能会节省大量内存。分配 ADL 时，此标志的行为与 DXGKARGCB_ALLOCATE_ADL 中同名的标志相同。

Flags.Reserved

保留;必须设置为零。

Flags.Value

访问 标志位的 替代方法。

[out] pAdl

成功调用 DXGKCB_PINFRAMEBUFFERFORSAVE2 时，指向包含帧缓冲区保存区域页面列表的 DXGK_ADL 结构。保证将这些页面映射到 IoMmu。