FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL fonction de rappel (vmbuskernelmodeclientlibapi.h)

Article
02/07/2025

[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 VmbChannelCreateGpadlFromMdl 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_MDL FnVmbChannelCreateGpadlFromMdl;

NTSTATUS FnVmbChannelCreateGpadlFromMdl(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PMDL Mdl,
  UINT32 StartOffsetWithinMdl,
  UINT32 DataLengthWithinMdl,
  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.

Mdl

Pointeur vers une chaîne MDL (Memory Descriptor List) qui décrit la mémoire tampon. La mémoire tampon peut avoir plusieurs éléments, qui sont chaînés à l’aide du pointeur suivant MDL.

StartOffsetWithinMdl

Offset, en octets, dans le MDL auquel démarrer le mappage.

DataLengthWithinMdl

Longueur, en octets, de la chaîne de mémoire tampon. Si cette valeur est égale à zéro (0), utilisez jusqu’à la fin du MDL.

GpadlHandle

Handle GPADL du MDL créé. 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 aura 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

Partager via