FN_VMB_PACKET_INITIALIZE fonction de rappel (vmbuskernelmodeclientlibapi.h)
[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 VmbPacketInitialize initialise une mémoire tampon pour contenir un paquet VMBus.
Syntaxe
FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;
NTSTATUS FnVmbPacketInitialize(
VMBCHANNEL Channel,
VMBPACKET VmbPacket,
UINT32 ByteCount
)
{...}
Paramètres
Channel
Handle pour un canal.
VmbPacket
Mémoire tampon à utiliser pour stocker le paquet VMBus.
ByteCount
Taille de Buffer, en octets.
Valeur retournée
VmbPacketInitialize retourne les codes status suivants :
| Code de retour | Description |
|---|---|
|
La fonction s’est terminée avec succès. |
|
La valeur de ByteCount n’est pas valide. Il doit être supérieur à la taille maximale du paquet plus la taille d’un pointeur void. |
Remarques
La taille de la mémoire tampon doit être au moins la taille calculée à l’aide de la fonction VmbChannelSizeofPacket .
VmbPacketInitialize est une alternative à la fonction VmbPacketAllocate . Utilisez la fonction actuelle si l’appelant fournit la mémoire de l’objet paquet.
La routine d’achèvement initiale du paquet n’est pas valide et doit être définie avant d’envoyer le paquet.
Important
Cette fonction est appelée par le biais de 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 |