FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER 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 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:
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 |