DXGKDDI_STOPDIRTYTRACKING 콜백 함수(d3dkmddi.h)

KMD의 DxgkDdiStopDirtyTracking 함수는 지정된 세그먼트 및 지정된 주소 범위 내에서 더티 비트 추적을 사용하지 않도록 설정합니다.

구문

DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;

NTSTATUS DxgkddiStopdirtytracking(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

매개 변수

hAdapter

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

hMemoryBasis

[in] 더티 작업 추적을 중지할 메모리 기준으로 처리합니다. KMD는 DxgkDdiCreateMemoryBasis에 대한 이전 호출에서 이 핸들을 만들었습니다.

반환 값

DxgkDdiStopDirtyTracking은 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 코드를 반환합니다.

설명

드라이버는 이전의 모든 시작 요청이 계속 적용되도록 해야 합니다. 예를 들어 KMD가 전체 세그먼트에서 더티 추적만 지원하고 더티 추적에 대한 미해결 요청이 두 개 있는 경우 한 요청만 중지하면 다른 요청에 대해 더티 비트 추적을 사용하도록 설정해야 합니다.

드라이버는 DxgkDdiStopDirtyTracking 호출이 해당 DxgkDdiStartDirtyTracking 호출과 동일한 메모리 범위를 지정하도록 보장할 수 있습니다. 예를 들어 Dxgkrnl이 세그먼트 1의 [0, 1GB)에서 더티 추적을 시작하도록 호출한 경우 결국 세그먼트 1의 세그먼트 [0, 1GB) 범위에서 더티 추적을 중지하라는 호출이 발생합니다.

자세한 내용은 더티 비트 추적을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 11 버전 24H2(WDDM 3.2)
머리글 d3dkmddi.h
IRQL PASSIVE_LEVEL

추가 정보

DxgkDdiCreateMemoryBasis

DxgkDdiStartDirtyTracking