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 |