EVT_VMB_CHANNEL_STARTED 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 de rappel EvtVmbChannelStarted est appelée sur l’un ou l’autre point de terminaison lorsqu’un canal est entièrement configuré, mais avant la remise des paquets. Cela se produit lorsque le point de terminaison opposé a ouvert le canal ou l’a rouvert après la fermeture.

Syntaxe

EVT_VMB_CHANNEL_STARTED EvtVmbChannelStarted;

void EvtVmbChannelStarted(
  [in] VMBCHANNEL Channel
)
{...}

Paramètres

[in] Channel

Canal démarré.

Valeur de retour

Aucun

Remarques

Une fois qu’un canal est créé, un pilote client peut spécifier des fonctions de rappel pour les modifications d’état, notamment EvtVmbChannelStarted, à l’aide de la fonction VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT.

Si un canal suspendu est ouvert ou qu’un canal ouvert est démarré, la bibliothèque cliente en mode noyau (KMCL) appelle EvtVmbChannelStarted après avoir appelé le rappel EvtVmbChannelOpened. EvtVmbChannelStarted pouvez appeler le VmbPacketSend, VmbPacketSendWithExternalMdlet VmbPacketSendWithExternalPfns fonctions pour mettre en file d’attente les paquets sortants. Étant donné que la file d’attente entrante n’est pas en cours d’exécution à ce stade, ce rappel ne doit pas bloquer les paquets entrants ou les achèvements.

La plupart des pilotes utilisant KMCL n’implémentent pas ce rappel. Une alternative est la fonction de rappel EvtVmbChannelPostStarted.

En attendant la fin d’un paquet envoyé, par exemple par la fonction VmbChannelSendSynchronousRequest, ne retourne jamais, car les paquets ne circulent pas lorsque ce rappel est appelé.