DXGKARGCB_PINFRAMEBUFFERFORSAVE2 구조체(d3dkmddi.h)

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 배수여야 하며 드라이버 초기화 중에 드라이버의 DxgkDdiQueryAdapterInfo 콜백이 DXGKQAITYPE_FRAMEBUFFERSAVESIZE 호출될 때 DXGK_FRAMEBUFFERSAVEAREA 구조에서 드라이버가 지정한 최대 크기보다 작거나 같아야 합니다.

Flags

Flags.PreferContiguous

드라이버가 이 경로에서 연속적인 ADL(주소 설명자 목록)을 사용할 수 있으며 페이지 배열보다 선호됨을 나타냅니다. 논리 다시 매핑을 사용하도록 설정하면 CommitSize를 기반으로 ADL을 할당할 때 많은 양의 메모리가 저장될 수 있습니다. 이 플래그는 ADL을 할당할 때 DXGKARGCB_ALLOCATE_ADL 동일한 이름의 플래그와 동일하게 동작합니다.

Flags.Reserved

예약; 를 0으로 설정해야 합니다.

Flags.Value

Flags 비트에 액세스하는 다른 방법입니다.

[out] pAdl

DXGKCB_PINFRAMEBUFFERFORSAVE2 성공적으로 호출하면 프레임 버퍼 저장 영역의 페이지 목록이 있는 DXGK_ADL 구조를 가리킵니다. 이러한 페이지는 IoMmu에 매핑되도록 보장됩니다.

설명

자세한 내용은 IOMMU DMA 다시 매핑 을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 서버	Windows Server 2022(WDDM 2.9)
머리글	d3dkmddi.h

추가 정보

DXGK_ADL

DXGK_FRAMEBUFFERSAVEAREA

DXGKCB_PINFRAMEBUFFERFORSAVE2

DxgkDdiQueryAdapterInfo