DXGKDDI_STARTDIRTYTRACKING Rückruffunktion (d3dkmddi.h)
Die dxgkDdiStartDirtyTracking--Funktion von KMD ermöglicht eine schmutzige Bitnachverfolgung innerhalb des angegebenen Segments und des angegebenen Adressbereichs.
Syntax
DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;
NTSTATUS DxgkddiStartdirtytracking(
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 gestartet werden soll. KMD hat dieses Handle in einem vorherigen Aufruf von DxgkDdiCreateMemoryBasiserstellt.
Rückgabewert
DxgkDdiStartDirtyTracking- gibt nach Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben.
Bemerkungen
Der Treiber muss nur sicherstellen, dass die schmutzige Nachverfolgung für die angegebene Speicherbasis aktiviert ist. Dies ist jedoch bei einer groberen Granularität (z. B. die Aktivierung der schmutzigen Nachverfolgung für den gesamten Adapter oder Segment) gültig, solange alle ausstehenden Anforderungen berücksichtigt werden.
Dxgkrnl- möglicherweise die Nachverfolgung von schmutzigen Seiten in mehreren Segmenten oder Bereichen innerhalb dieser Segmente gleichzeitig aktivieren.
Wenn die schmutzige Nachverfolgung aktiviert ist, erwartet Dxgkrnl dass der schmutzige Bitplan auf alle Nullen initialisiert wird (alle Seiten unverändert).
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 |