DXGKCB_PINFRAMEBUFFERFORSAVE2 콜백 함수(d3dkmddi.h)

커널 모드 디스플레이 미니포트 드라이버는 DXGKCB_PINFRAMEBUFFERFORSAVE2 호출하여 전체 프레임 버퍼를 한 번에 고정합니다.

구문

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

NTSTATUS DxgkcbPinframebufferforsave2(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터에 대한 핸들입니다. 드라이버는 LDA(연결된 디스플레이 어댑터) 체인의 기본/리드 디바이스에 대해 이 핸들을 제공합니다.

[in/out] pPinFrameBufferForSave2

저장할 프레임 버퍼에 대한 정보가 포함된 DXGKARGCB_PINFRAMEBUFFERFORSAVE2 구조체에 대한 포인터입니다.

반환 값

DXGKCB_PINFRAMEBUFFERFORSAVE2 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 는 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

원래 WDDM 2.4 IOMMU 구현 에는 프레임 버퍼를 저장하는 데 필요한 메모리를 쿼리하는 콜백 함수 쌍이 포함되어 있습니다. 프레임 버퍼 저장 영역은 초기화 중에 섹션 개체로 만들어졌으며, 드라이버는 이러한 콜백을 사용하여 필요할 때 IOMMU 매핑된 영역을 얻었습니다.

논리 DMA 다시 매핑을 지원하기 위해 ADL(주소 설명자 목록)을 사용하는 드라이버는 DXGKARGCB_PINFRAMEBUFFERFORSAVE 대신 DXGKCB_PINFRAMEBUFFERFORSAVE2 구현합니다.

DXGKCB_PINFRAMEBUFFERFORSAVE2 사용하여 고정된 메모리는 원래 DXGKCB_UNPINFRAMEBUFFERFORSAVE 콜백을 사용하여 고정 해제할 수 있습니다.

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

DXGKCB_XXX 함수는 Dxgkrnl에 의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKARGCB_PINFRAMEBUFFERFORSAVE2 적절한 멤버를 설정한 다음 DXGKRNL_INTERFACE 통해 DxgkCbPinFrameBufferForSave2를 호출합니다.

요구 사항

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

추가 정보

DXGKARGCB_PINFRAMEBUFFERFORSAVE2

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE