DXGKDDI_SAVEMUTABLEMIGRATIONDATA Rückruffunktion (d3dkmddi.h)
Kmds DxgkDdiSaveMutableMigrationData--Funktion sammelt veränderbare Daten für eine Livemigration, die etwa beendet wird.
Syntax
DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;
NTSTATUS DxgkddiSavemutablemigrationdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}
Parameter
hAdapter
[in] Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor für Dxgkrnl- im MiniportDeviceContext Ausgabeparameter der DXGKDDI_ADD_DEVICE-Funktion bereitgestellt.
pArgs
[in/out] Zeigen Sie auf eine DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA Struktur für Informationen im Zusammenhang mit dem Aufruf.
Rückgabewert
DxgkDdiSaveMutableMigrationData gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben.
Bemerkungen
DxgkDdiSaveMutableMigrationData wird aufgerufen, änderbare Daten zu sammeln, wenn eine Livemigration beendet wird. Dieser DDI sollte immer nur für VFs aufgerufen werden, die derzeit angehalten sind.
DxgkDdiSaveMutableMigrationData wird im klassischen dynamischen Puffermuster aufgerufen:
- Beim ersten Aufruf wird DataSize- auf 0 und Data auf NULL festgelegt. KMD sollte DataSize- in die Gesamtanzahl der Bytes ändern, die zum Speichern der unveränderlichen Daten erforderlich sind.
- Dxgkrnl erstellt einen Puffer von DataSize Bytes und führt einen zweiten Aufruf durch, wobei DataSize auf den von KMD zurückgegebenen Wert festgelegt ist, und Data auf den zugeordneten Puffer zeigt. Dxgkrnl- steuert die Lebensdauer dieses zugewiesenen Speichers nach dem Aufruf.
DxgkDdiSaveImmutableMigrationData- wird zu Beginn einer Livemigration aufgerufen, um unveränderliche Daten zu sammeln.
Weitere Informationen finden Sie unter Livemigration auf GPU-P Geräten.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 24H2 (WDDM 3.2) |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |