Freigeben über


DXGKDDI_QUERYDIRTYBITDATA Rückruffunktion (d3dkmddi.h)

Dxgkrnl- ruft DxgkDdiQueryDirtyBitData- auf, um eine Kopie der schmutzigen Bitplandaten aus dem Kernelmodus-Miniporttreiber (KMD) anzufordern.

Syntax

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

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

Parameter

hAdapter

[in] Ein Handle zu einem Kontextblock, der einem Anzeigeadapter 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.

Bemerkungen

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

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

Weitere Informationen finden Sie unter Dirty Bit Tracking.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 24H2 (WDDM 3.2)
Header- d3dkmddi.h
IRQL- PASSIVE_LEVEL

Siehe auch

DXGKARG_QUERYDIRTYBITDATA