FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER fonction de rappel (vmbuskernelmodeclientlibapi.h)

Article
03/01/2024

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant 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 de instantané et de migration dynamique.

Buffer

Mémoire tampon, qui est sondée 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 retournée

Retourne STATUS_SUCCESS si l’opération réussit, ou un code d’erreur NTSTATUS approprié dans le cas contraire.

Remarques

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

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

Important

Cette fonction est appelée via l’interface KMCL (Kernel Mode Client Library) VMBus, 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 du KMCL_CLIENT_INTERFACE_V1.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	vmbuskernelmodeclientlibapi.h

Voir aussi

VmbChannelDeleteGpadl

VmbChannelMapGpadl

Partager via