NdisMCoActivateVcComplete, fonction (ndis.h)
NdisMCoActivateVcComplete avertit NDIS et le gestionnaire d’appels que le pilote miniport a terminé le traitement d’une requête activate-VC initiée par CM, pour laquelle le pilote miniport a précédemment retourné NDIS_STATUS_PENDING.
Syntaxe
void NdisMCoActivateVcComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Paramètres
[in] Status
Spécifie l’état final de l’opération activate-VC, qui peut être NDIS_STATUS_SUCCESS ou n’importe quel NDIS_STATUS_ XXX, sauf NDIS_STATUS_PENDING.
[in] NdisVcHandle
Spécifie le handle identifiant le vc. L’appelant a obtenu ce handle à partir de son état par VC, désigné par le MiniportVcContext passé en tant que paramètre d’entrée à son fonction MiniportCoActivateVc.
[in] CallParameters
Pointeur vers une structure de type CO_CALL_PARAMETERS, fournie par le gestionnaire d’appels, en spécifiant les paramètres d’appel et de média pour l’activation VC.
Valeur de retour
Aucun
Remarques
Un pilote miniport orienté connexion doit appeler NdisMCoActivateVcComplete si sa fonction MiniportCoActivateVc précédemment retournée NDIS_STATUS_PENDING en réponse à une demande d’activation ou de réactivation de la vc identifiée par le NdisVcHandle donné. Le gestionnaire d’appels, qui a lancé l’activation VC avec un appel à NdisCmActivateVc, ne peut pas notifier NDIS ou son client si les transferts sur la vc peuvent être effectués à l’aide des paramètres d’appel fournis jusqu’à ce que le pilote miniport appelle NdisMCoActivateVcComplete.
Si le pilote miniport trouve les paramètres d’appel fournis par CM inacceptables, l’activation VC échoue lorsqu’elle appelle NdisMCoActivateVcComplete. L’échec de l’activation initiale d’une vc peut entraîner la destruction du protocole qui a créé la vc. Si le pilote miniport échoue une requête pour réactiver une vc établie avec de nouveaux paramètres d’appel, elle doit restaurer les paramètres d’appel d’origine établis pour cette vc. Selon la nature du support réseau, un pilote miniport peut modifier les paramètres multimédias si les indicateurs arrondis et/ou arrondis sont définis avant d’appeler NdisMCoActivateVcComplete.
Un appel à NdisMCoActivateVcComplete entraîne l’appel de NDIS ProtocolCmActivateVcComplete fonction du gestionnaire d’appels qui a initialement demandé l’activation VC.