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 |