DXGKARG_QUERYDIRTYBITDATA-Struktur (d3dkmddi.h)

DXGKARG_QUERYDIRTYBITDATA ist ein Eingabe-/Ausgabeparameter für DxgkDdiQueryDirtyBitData zum Abfragen modifiziert Bitplandaten.

Syntax

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

Member

MemoryBasis

[in] Handle für die Sammlung von Bereichen physischer Speicherseiten, von der die geänderte status abgefragt werden soll. Dieses Handle wurde zuvor durch einen Aufruf von DxgkDdiCreateMemoryBasis erstellt.

SubrangeIndex

[in] Wenn ein Unterbereich angegeben wird (siehe SubrangeSize unten), stellen diese Daten dar, aus welchem Bereich in der Speicherbasis abfragen werden soll.

SubrangeOffset

[in] Wenn SubrangeSize nicht 0 ist, stellt SubrangeOffset einen optionalen Offset in den ausgewählten Teilbereich dar, aus dem die aktuelle modifiziert Bitebene abfragt werden soll. Dieser Wert ist ein Offset in Bytes und ist immer ein Vielfaches der Seitengröße der Bitebene.

SubrangeSize

[in] Gibt den Bereich der abzufragenden Speicherbasis an. Wenn SubrangeSize auf 0 festgelegt ist, sollte der Treiber die gesamte Speicherbasis abfragen. Wenn eine Größe ungleich Null angegeben wird, sollte der Treiber einen einzelnen Bereich der Speicherbasis abfragen, wobei SubrangeIndex und SubrangeOffset den Startindex des abzufragenden physischen Intervalls bereitstellen. SubrangeSize ist in Bytes und ist immer ein Vielfaches der Bitplane-Seitengröße.

Buffer

[out] Ein Puffer, in den die resultierenden Bitplanendaten geschrieben werden sollen.

BufferSize

[out] Die Größe des Bitebenenpuffers in Bytes. Die Größe ist garantiert groß genug, um ein Bit pro Seite in den angegebenen Unterbereich zu passen, der mindestens Size/DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS::PageSize/8 (aufgerundet) Bytes ist. Wenn ein einzelner Teilbereich abgefragt wird, stellt BufferSizeSubrangeSize dar. Wenn auf die gesamte Speicherbasis verwiesen wird, ist BufferSize die Summe aller SizeInBytes der Bereiche in der Basis.

Flags

[in] Mindestens ein DXGKARG_QUERYDIRTYBITDATAFLAGS Werte, die zusätzliches Verhalten für den Aufruf angeben.

Hinweise

Weitere Informationen finden Sie unter Dirty Bit Tracking.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11, Version 24H2 (WDDM 3.2)
Kopfzeile	d3dkmddi.h

Weitere Informationen

DXGKARG_QUERYDIRTYBITDATAFLAGS

DxgkDdiCreateMemoryBasis

DxgkDdiQueryDirtyBitData