DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA Rückruffunktion (d3dkmddi.h)
Kmds DxgkDdiSaveImmutableMigrationData-Funktion speichert unveränderliche Daten für eine Livemigration, die gerade gestartet werden soll.
Syntax
DXGKDDI_SAVEIMMUTABLEMIGRATIONDATA DxgkddiSaveimmutablemigrationdata;
NTSTATUS DxgkddiSaveimmutablemigrationdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_GPUP_SAVE_IMMUTABLE_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_IMMUTABLE_MIGRATION_DATA Struktur für Informationen im Zusammenhang mit dem Aufruf.
Rückgabewert
DxgkDdiSaveImmutableMigrationData gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben.
Bemerkungen
Nach dem Aufrufen der DxgkDdiPrepareLiveMigration--Funktion ruft Dxgkrnl dannDxgkDdiSaveImmutableMigrationData- auf, um Informationen zum Gerät zu sammeln, die auf der Zielseite wiederhergestellt werden sollen. Dieser Punkt ist auch eine Möglichkeit für das System, die Konfiguration des Remotecomputers zu überprüfen. Daher sollten DxgkDdiSaveImmutableMigrationData- genügend Informationen packen, um alle Hardware-, Firmware- oder Treiberüberprüfungsdaten zu überprüfen, die die Funktion zum Verschieben des VF in die Zielkonfiguration erkennen können.
Der Treiber sollte Daten über den VF speichern, die sich nicht ändern, während es aktiv ist, dass der KMD des Ziels zum Initialisieren des neuen VF verwendet werden kann. Diese Daten müssen nicht die vGPU-Erstellungsparameter enthalten, da diese in niedrigeren Ebenen übertragen und zum Erstellen der vGPU mithilfe der normalen DDI verwendet werden. Dies kann alle Daten enthalten, die unveränderlich an den VF gebunden sind, und nicht alle müssen auf der Zielseite wiederhergestellt werden. Daten können ausschließlich zu Validierungszwecken gesendet werden, was ein wichtiger Bestandteil dieser Schnittstelle ist.
DxgkDdiSaveImmutableMigrationData- 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.
DxgkDdiSaveMutableMigrationData- wird am Ende einer Livemigration aufgerufen, um veränderbare 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 |