FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER 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 VmbChannelCreateGpadlFromBuffer-Funktion erstellt eine Gastadressendeskriptorliste (GPADL), die einen clientseitigen Puffer beschreibt. Die GPADL kann auf dem Server verwendet werden, um auf den Puffer zuzugreifen.

Syntax

FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER FnVmbChannelCreateGpadlFromBuffer;

NTSTATUS FnVmbChannelCreateGpadlFromBuffer(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PVOID Buffer,
  UINT32 ByteCount,
  PUINT32 GpadlHandle
)
{...}

Parameter

Channel

Ein Handle für einen Kanal.

Flags

Flaggen. Folgende Werte sind möglich:

Wert Bedeutung
VMBUS_CHANNEL_GPADL_READ_ONLY
 Wenn Sie diesen Wert angeben, ist der Puffer schreibgeschützt. Andernfalls kann der Server in den Puffer schreiben. Dies ist keine Sicherheitsmaßnahme, kann aber Momentaufnahme und Livemigrationsleistung verbessern.

Buffer

Der Puffer, der so lange abgetastet und gesperrt wird, bis das GPADL abgerissen wird.

ByteCount

Die Länge des Puffers in Bytes.

GpadlHandle

Ein GPADL-Handle der erstellten Speicherdeskriptorliste (Memory Descriptor List, MDL). Senden Sie diese An den Server, um sie mit der Funktion VmbChannelMapGpadl zu verwenden.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder andernfalls einen entsprechenden NTSTATUS-Fehlercode.

Hinweise

Wenn diese Funktion zurückgegeben wird, kann der Serverendpunkt VmbChannelMapGpadl aufrufen, da VMBus die GPADL-Beschreibung bereits an den entgegengesetzten Endpunkt gesendet und eine Bestätigung erhalten hat.

Die GPADL muss mithilfe der Funktion VmbChannelDeleteGpadl gelöscht werden.

Wichtig

Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine Clientfunktion, auf die über die KMCL_CLIENT_INTERFACE_V1-Struktur zugegriffen wird.

Weitere Informationen finden Sie im Abschnitt Hinweise des KMCL_CLIENT_INTERFACE_V1.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1803
Kopfzeile vmbuskernelmodeclientlibapi.h

Weitere Informationen

VmbChannelDeleteGpadl

VmbChannelMapGpadl