DXGKDDI_QUERYDIRTYBITDATA Rückruffunktion (d3dkmddi.h)

Dxgkrnl ruft DxgkDdiQueryDirtyBitData auf, um eine Kopie der modifiziert Bitplanedaten vom Kernelmodusanzeige-Miniporttreiber (KMD) anzufordern.

Syntax

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

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

Parameter

hAdapter

[in] Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. KMD hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der DxgiDdiAddDevice-Funktion bereitgestellt.

pArgs

[in/out] Ein Zeiger auf eine DXGKARG_QUERYDIRTYBITDATA-Struktur , die Eingabe- und Ausgabeinformationen für die Abfrage enthält.

Rückgabewert

DxgkDdiQueryDirtyBitData gibt STATUS_SUCCESS zurück, wenn die Abfrage erfolgreich war. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Die Funktion stellt die Speicherbasis und potenzielle Teilbereichsbezeichner für die angeforderten modifiziert Informationen bereit. KMD muss die resultierenden Daten in den Ausgabepuffer schreiben. DxgkDdiQueryDirtyBitData ermöglicht entweder das Abfragen aller Bereiche der Speicherbasis oder eines einzelnen Bereichs.

Wenn Arbeitsspeicher verfügbar ist, versucht Dxgkrnl , diesen Vorgang mithilfe eines einzigen Aufrufs zu beschleunigen, um alle benötigten Daten gleichzeitig abzufragen. Unter geringen Arbeitsspeicherbedingungen kann jedoch der Vorwärtsfortschritt mit einem kleineren Puffer mit fester Größe erforderlich sein. Dies ist nur eine kleinere Teilmenge der Speicherbasis, die von einem vorherigen Aufruf von DdiStartDirtyTracking nachverfolgt wird. Der angeforderte modifiziert Bitplanebereich überschreitet niemals einen aktiv nachverfolgten modifiziert Bereich.

Weitere Informationen finden Sie unter Dirty Bit Tracking.

Anforderungen

Weitere Informationen

DXGKARG_QUERYDIRTYBITDATA