FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
02/07/2025

[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 VmbChannelCreateGpadlFromMdl-Funktion erstellt eine Clientseitige Adressbeschreibungsliste (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_MDL FnVmbChannelCreateGpadlFromMdl;

NTSTATUS FnVmbChannelCreateGpadlFromMdl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PMDL Mdl,
  UINT32 StartOffsetWithinMdl,
  UINT32 DataLengthWithinMdl,
  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 jedoch die Leistung von Momentaufnahmen und Livemigrationen verbessern.

Mdl

Ein Zeiger auf eine MDL-Kette (Memory Descriptor List), die den Puffer beschreibt. Der Puffer kann mehrere Teile aufweisen, die mithilfe des nächsten MDL-Zeigers verkettet werden.

StartOffsetWithinMdl

Ein Offset in Bytes in der MDL, bei der die Zuordnung gestartet werden soll.

DataLengthWithinMdl

Die Länge der Pufferkette in Bytes. Wenn dieser Wert null (0) ist, verwenden Sie bis zum Ende der MDL.

GpadlHandle

Das GPADL-Handle der erstellten MDL. Senden Sie dies an den Server, der mit der VmbChannelMapGpadl--Funktion verwendet werden soll.

Rückgabewert

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

Bemerkungen

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 VmbChannelDeleteGpadl--Funktion 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
mindestens unterstützte Client-	Windows 10, Version 1803
Header-	vmbuskernelmodeclientlibapi.h

Siehe auch

VmbChannelDeleteGpadl-

VmbChannelMapGpadl-

Freigeben über