FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL 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 VmbChannelCreateGpadlFromMdl-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_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:

Mdl

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

StartOffsetWithinMdl

Ein Offset in Bytes in der MDL, an 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 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.

Anforderungen

Weitere Informationen

VmbChannelDeleteGpadl

VmbChannelMapGpadl