FN_VMB_CHANNEL_MAP_GPADL Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]
Die VmbChannelMapGpadl--Funktion ordnet einen clientseitigen Puffer mithilfe einer GPADL-Nummer (Guest Physical Address Descriptor List) einem 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 |
|---|---|
|
Karte 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 von Livemigration und Snapshotting zu verbessern.
GpadlHandle
Das GPADL-Handle des GPADL, das zugeordnet werden soll.
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 einen entsprechenden NTSTATUS-Fehlercode andernfalls.
Bemerkungen
Die GPADL muss z. B. mithilfe der funktion VmbChannelCreateGpadlFromBuffer vom Client vorinstalliert sein.
Es kann jeweils nur eine einzelne Zuordnung für ein bestimmtes GPADL vorhanden sein.
Sie müssen Aufrufe dieser Funktion mit Aufrufen der VmbChannelUnmapGpadl Funktion 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 servergeschützte Funktion, 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 |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1803 |
| Header- | vmbuskernelmodeclientlibapi.h |