DXGKDDI_STOPDIRTYTRACKING Rückruffunktion (d3dkmddi.h)
Die dxgkDdiStopDirtyTracking-Funktion von KMD deaktiviert die schmutzige Bitnachverfolgung innerhalb des angegebenen Segments und des angegebenen Adressbereichs.
Syntax
DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;
NTSTATUS DxgkddiStopdirtytracking(
IN_CONST_HANDLE hAdapter,
IN_CONST_HANDLE hMemoryBasis
)
{...}
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.
hMemoryBasis
[in] Behandeln Sie die Speicherbasis, über die die Nachverfolgung von schmutzigen Vorgängen beendet werden soll. KMD hat dieses Handle in einem vorherigen Aufruf von DxgkDdiCreateMemoryBasiserstellt.
Rückgabewert
DxgkDdiStopDirtyTracking gibt nach Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben.
Bemerkungen
Der Treiber sollte sicherstellen, dass alle vorherigen Startanforderungen weiterhin berücksichtigt werden. Wenn KMD z. B. nur die schmutzige Nachverfolgung für das gesamte Segment gleichzeitig unterstützt und zwei ausstehende Anforderungen für die schmutzige Nachverfolgung vorhanden sind, sollte das Beenden nur einer Anforderung die Schmutzige Bitnachverfolgung für die andere Anforderung aktiviert lassen.
Der Treiber kann garantiert werden, dass ein Aufruf von DxgkDdiStopDirtyTracking dieselben Speicherbereiche wie die entsprechenden DxgkDdiStartDirtyTracking- Aufrufe angibt. Wenn z. B. Dxgkrn l einen Anruf getätigt hat, um die schmutzige Nachverfolgung auf [0, 1 GB) von Segment 1 zu starten, wird es schließlich einen Aufruf geben, um die schmutzige Nachverfolgung im Segment [0, 1 GB) im Segment 1 zu beenden.
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 |