FN_VMB_CHANNEL_MAP_GPADL Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
Die VmbChannelMapGpadl-Funktion ordnet einen clientseitigen Puffer mithilfe einer GPADL-Nummer (Guest Physical Address Descriptor List) dem serverseitigen physischen Adressraum zu.
Syntax
FN_VMB_CHANNEL_MAP_GPADL FnVmbChannelMapGpadl;
NTSTATUS FnVmbChannelMapGpadl(
VMBCHANNEL Channel,
UINT32 Flags,
UINT32 GpadlHandle,
PMDL *Mdl
)
{...}
Parameter
Channel
Ein Handle für einen Kanal.
Flags
Flaggen. Die möglichen Flagwerte sind:
| Wert | Bedeutung |
|---|---|
|
Zuordnung mit schreibgeschütztem Zugriff. |
Wenn dieser Flagwert nicht festgelegt ist, versucht die Funktion, die GPADL für den Schreibzugriff zuzuordnen. Wenn die GPADL nicht mit Schreibzugriff erstellt wurde, schlägt dieser Zuordnungsversuch fehl. Der Aufrufer wird nicht daran gehindert, in den Puffer zu schreiben, wenn dieses Flag festgelegt ist. Dieses Schema wird verwendet, um die Leistung der Livemigration und Momentaufnahme zu verbessern.
GpadlHandle
Der GPADL-Handle des zuzuordnenden GPADL.
Mdl
Ein Zeiger auf eine MDL, die den Clientpuffer beschreibt. Dieser Puffer wird nur dem physischen Adressraum zugeordnet. Der Aufrufer muss zusätzliche Schritte ausführen, um ihn dem virtuellen Adressraum zuzuordnen.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder andernfalls einen entsprechenden NTSTATUS-Fehlercode.
Hinweise
Die GPADL muss vom Client für instance mithilfe der Funktion VmbChannelCreateGpadlFromBuffer vorab eingerichtet worden sein.
Für eine bestimmte GPADL-Datei kann jeweils nur eine einzelne Zuordnung vorhanden sein.
Sie müssen Aufrufe dieser Funktion mit Aufrufen der Funktion VmbChannelUnmapGpadl koppeln .
Wichtig
Diese Funktion wird über die KMCL-Schnittstelle (VmBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine reine Serverfunktion, auf die über die KMCL_SERVER_ONLY_METHODS-Struktur zugegriffen wird.
Weitere Informationen finden Sie im Abschnitt Hinweise von KMCL_SERVER_ONLY_METHODS.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| Kopfzeile | vmbuskernelmodeclientlibapi.h |