DXGKDDI_QUERYDIRTYBITDATA 콜백 함수(d3dkmddi.h)

Dxgkrnl은DxgkDdiQueryDirtyBitData를 호출하여 커널 모드 디스플레이 미니포트 드라이버(KMD)에서 더티 비트플레인 데이터의 복사본을 요청합니다.

구문

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

매개 변수

hAdapter

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

pArgs

[in/out] 쿼리에 대한 입력 및 출력 정보를 포함하는 DXGKARG_QUERYDIRTYBITDATA 구조체에 대한 포인터입니다.

반환 값

DxgkDdiQueryDirtyBitData 는 쿼리가 성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

함수는 요청된 더티 정보에 대한 메모리 기반 및 잠재적 하위 범위 식별자를 제공합니다. KMD는 결과 데이터를 출력 버퍼에 써야 합니다. DxgkDdiQueryDirtyBitData 를 사용하면 메모리 기반의 모든 범위 또는 단일 범위를 쿼리할 수 있습니다.

메모리를 쉽게 사용할 수 있는 경우 Dxgkrnl 은 단일 호출을 사용하여 필요한 모든 데이터를 한 번에 쿼리하여 이 작업을 가속화하려고 합니다. 그러나 메모리가 부족한 상태에서는 더 작은 고정 크기 버퍼를 사용하여 전달 진행이 필요할 수 있습니다. 이는 DdiStartDirtyTracking에 대한 이전 호출에서 추적되는 메모리 기준의 작은 하위 집합일 뿐입니다. 요청된 더티 비트플레인 범위는 적극적으로 추적된 더티 범위를 초과하지 않습니다.

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

요구 사항

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

추가 정보

DXGKARG_QUERYDIRTYBITDATA