DXGKDDI_SAVEMUTABLEMIGRATIONDATA Rückruffunktion (d3dkmddi.h)
Die DxgkDdiSaveMutableMigrationData-Funktion von KMD sammelt veränderliche Daten für eine Livemigration, die vor dem Ende steht.
Syntax
DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;
NTSTATUS DxgkddiSavemutablemigrationdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}
Parameter
hAdapter
[in] Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Der Anzeigeminiporttreiber hat dieses Handle zuvor für Dxgkrnl im Ausgabeparameter MiniportDeviceContext der DXGKDDI_ADD_DEVICE-Funktion bereitgestellt.
pArgs
[ein/aus] Zeiger 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.
Hinweise
DxgkDdiSaveMutableMigrationData wird aufgerufen, um veränderliche Daten zu sammeln, wenn eine Livemigration beendet wird. Dieser DDI sollte immer nur für VFs aufgerufen werden, die derzeit angehalten werden.
DxgkDdiSaveMutableMigrationData wird im klassischen dynamischen Puffermuster aufgerufen:
- Beim ersten Aufruf ist DataSize auf 0 und Data auf NULL festgelegt. KMD sollte DataSize in die Gesamtanzahl von Bytes ändern, die zum Speichern der unveränderlichen Daten erforderlich ist.
- Dxgkrnl erstellt einen Puffer von DataSize-Bytes und führt einen zweiten Aufruf aus, wobei DataSize auf den von KMD zurückgegebenen Wert festgelegt ist, und Data zeigt auf den zugeordneten Puffer. Dxgkrnl steuert die Lebensdauer dieses zugewiesenen Arbeitsspeichers 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 (WDDM 3.2) |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |