DXGKARG_QUERYDIRTYBITDATA 구조체(d3dkmddi.h)

DXGKARG_QUERYDIRTYBITDATA 더티 비트플레인 데이터를 쿼리하는 데 사용할 DxgkDdiQueryDirtyBitData에 대한 입력/출력 매개 변수입니다.

구문

typedef struct _DXGKARG_QUERYDIRTYBITDATA {
  HANDLE MemoryBasis;
  UINT64 SubrangeIndex;
  UINT64 SubrangeOffset;
  UINT64 SubrangeSize;
  PVOID  Buffer;
  SIZE_T BufferSize;
  UINT   Flags;
} DXGKARG_QUERYDIRTYBITDATA;

멤버

MemoryBasis

[in] 수정된 상태 쿼리할 실제 메모리 페이지의 범위 컬렉션에 대한 핸들입니다. 이 핸들은 이전에 DxgkDdiCreateMemoryBasis를 호출하여 만들었습니다.

SubrangeIndex

[in] 하위 범위가 표시되는 경우(아래 SubrangeSize 참조) 이 데이터는 쿼리할 메모리 기준 범위를 나타냅니다.

SubrangeOffset

[in] SubrangeSize가 0이 아닌 경우 SubrangeOffset은 현재 더티 비트플레인을 쿼리할 하위 범위로 선택적 오프셋을 나타냅니다. 이 값은 오프셋(바이트)이며 항상 비트플레인 페이지 크기의 배수입니다.

SubrangeSize

[in] 쿼리할 메모리 기준의 범위를 지정합니다. SubrangeSize가 0이면 드라이버는 전체 메모리를 쿼리해야 합니다. 0이 아닌 크기를 지정하면 드라이버는 메모리 기준의 단일 범위를 쿼리해야 합니다. 여기서 SubrangeIndex 및 SubrangeOffset 은 쿼리할 실제 간격의 시작 인덱스를 제공합니다. SubrangeSize 는 바이트 단위이며 항상 비트플레인 페이지 크기의 배수입니다.

Buffer

[out] 결과 비트플레인 데이터를 쓸 버퍼입니다.

BufferSize

[out] 비트 평면 버퍼의 크기(바이트)입니다. 크기는 지정된 하위 범위 내에서 페이지당 1비트(최소 Size/DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS::PageSize/8 (반올림) 바이트 내에 들어갈 수 있을 만큼 충분히 커야 합니다. 단일 하위 범위를 쿼리하는 경우 BufferSize 는 SubrangeSize를 나타내고, 전체 메모리 기반이 참조되는 경우 BufferSize 는 범위의 모든 SizeInBytes 의 합계입니다.

Flags

[in] 호출에 대한 추가 동작을 지정하는 하나 이상의 DXGKARG_QUERYDIRTYBITDATAFLAGS 값입니다.

설명

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

요구 사항

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

추가 정보

DXGKARG_QUERYDIRTYBITDATAFLAGS

DxgkDdiCreateMemoryBasis

DxgkDdiQueryDirtyBitData