DXGKDDI_SAVEMUTABLEMIGRATIONDATA 콜백 함수(d3dkmddi.h)

아티클
05/23/2024

KMD의 DxgkDdiSaveMutableMigrationData 함수는 종료할 실시간 마이그레이션을 위해 변경 가능한 데이터를 수집합니다.

구문

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

NTSTATUS DxgkddiSavemutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}

매개 변수

hAdapter

[in] 디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DXGKDDI_ADD_DEVICE 함수의 MiniportDeviceContext 출력 매개 변수에서 Dxgkrnl에 이 핸들을 제공했습니다.

pArgs

[in/out] 호출과 관련된 정보에 대한 DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA 구조체에 대한 포인터입니다.

반환 값

DxgkDdiSaveMutableMigrationData 는 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 코드를 반환합니다.

설명

DxgkDdiSaveMutableMigrationData 는 실시간 마이그레이션이 종료되려고 할 때 변경 가능한 데이터를 수집하기 위해 호출됩니다. 이 DDI는 현재 일시 중지된 VF에 대해서만 호출되어야 합니다.

DxgkDdiSaveMutableMigrationData 는 클래식 동적 버퍼 패턴에서 호출됩니다.

첫 번째 호출에서 DataSize 는 0으로, Data 는 NULL로 설정됩니다. KMD는 변경 불가능한 데이터를 저장하는 데 필요한 총 바이트 수로 DataSize 를 변경해야 합니다.
Dxgkrnl은 DataSize 바이트의 버퍼를 만들고 할당된 버퍼를 가리키는 KMD 및 Data에서 반환하는 값으로 설정된 DataSize를 사용하여 두 번째 호출을 합니다. Dxgkrnl 은 호출 후 할당된 이 메모리의 수명을 제어합니다.

DxgkDdiSaveImmutableMigrationData 는 변경할 수 없는 데이터를 수집하기 위해 실시간 마이그레이션을 시작할 때 호출됩니다.

자세한 내용은 GPU-P 디바이스에서 실시간 마이그레이션을 참조하세요.