FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER fonction de rappel (vmbuskernelmodeclientlibapi.h)

[Certaines informations concernent le produit préversion qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.]

La fonction VmbChannelCreateGpadlFromBuffer crée une liste de descripteurs d’adresses physiques invitées (GPADL) qui décrit une mémoire tampon côté client. Le GPADL peut être utilisé dans le serveur pour accéder à la mémoire tampon.

Syntaxe

FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER FnVmbChannelCreateGpadlFromBuffer;

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

Paramètres

Channel

Handle pour un canal.

Flags

Drapeaux. Les valeurs possibles sont les suivantes :

Valeur	Signification
VMBUS_CHANNEL_GPADL_READ_ONLY	Si vous spécifiez cette valeur, la mémoire tampon est en lecture seule. Sinon, le serveur peut écrire dans la mémoire tampon. Il ne s’agit pas d’une mesure de sécurité, mais peut améliorer les performances d’instantané et de migration dynamique.

Buffer

Mémoire tampon, qui est sonde et verrouillée jusqu’à ce que le GPADL soit détruit.

ByteCount

Longueur de la mémoire tampon, en octets.

GpadlHandle

Handle GPADL de la liste de descripteurs de mémoire (MDL) créée. Envoyez-le au serveur à utiliser avec la fonction VmbChannelMapGpadl.

Valeur de retour

Retourne STATUS_SUCCESS si l’opération réussit, ou si un code d’erreur NTSTATUS approprié sinon.

Remarques

Lorsque cette fonction est retournée, le point de terminaison du serveur peut appeler VmbChannelMapGpadl, car VMBus a déjà envoyé la description GPADL au point de terminaison opposé et reçu la confirmation.

Le GPADL doit être supprimé à l’aide de la fonction VmbChannelDeleteGpadl.

Important

Cette fonction est appelée par le biais de l’interface KMCL (VmBus Kernel Mode Client Library), fournie par le pilote de bus Vmbkmcl.sys. Il s’agit d’une fonction cliente accessible à partir de la structure KMCL_CLIENT_INTERFACE_V1.

Pour plus d’informations, consultez la section Remarques de la KMCL_CLIENT_INTERFACE_V1.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1803
d’en-tête	vmbuskernelmodeclientlibapi.h

Voir aussi

VmbChannelDeleteGpadl

VmbChannelMapGpadl