FN_VMB_CHANNEL_MAP_GPADL Rückruffunktion (vmbuskernelmodeclientlibapi.h)

  • Artikel

[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
VMBUS_CHANNEL_GPADL_FLAG_READ_ONLY
 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

Weitere Informationen

VmbChannelCreateGpadlFromBuffer

VmbChannelUnmapGpadl