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