DXGKCB_SAVEMEMORYFORHOTUPDATE 콜백 함수(d3dkmddi.h)

  • 아티클

커널 모드 디스플레이 미니포트 드라이버는 DXGKCB_SAVEMEMORYFORHOTUPDATE 호출하여 어댑터 메모리를 저장하여 드라이버 핫 업데이트를 지원할 수 있습니다.

구문

DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;

NTSTATUS DxgkcbSavememoryforhotupdate(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}

매개 변수

[in] hAdapter

DxgkDdiStartDevice에 전달되는 DXGK 어댑터에 대한 핸들입니다.

[in] pArgs

이 콜백에 대한 인수를 포함하는 DXGKARGCB_SAVEMEMORYFORHOTUPDATE 구조체에 대한 포인터입니다.

반환 값

DXGKCB_SAVEMEMORYFORHOTUPDATE 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에서 오류 코드를 반환합니다.

설명

DXGKCB_SAVEMEMORYFORHOTUPDATE 호출할 때마다 물리적 메모리 페이지 블록과 드라이버가 메모리 블록과 연결하려는 메타데이터가 선택적으로 저장됩니다. 페이지가 복원되면 드라이버는 메타데이터와 함께 저장된 각 메모리 블록에 대해 별도의 호출을 받습니다.

편의를 위해 콜백은 물리적 메모리를 저장하는 3가지 옵션을 제공합니다.

  • 연속된 물리적 메모리 범위의 배열로(pDataMemoryRanges)
  • MDL(pDataMdl)
  • 가상 메모리 버퍼로(pData)

데이터에 대한 포인터 중 하나(및 하나만)(pDataMemoryRanges, pDataMdl 또는 pData)는 NULL이 아니어야 합니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 버전 1903(WDDM 2.6)
머리글 d3dkmddi.h
IRQL PASSIVE_LEVEL

추가 정보

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE