Fonction NdisMCoActivateVcComplete (ndis.h)
NdisMCoActivateVcComplete avertit NDIS et le gestionnaire d’appels que le pilote miniport a terminé le traitement d’une demande activate-VC lancé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 la status finale 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, spécifiant les paramètres d’appel et de média pour l’activation vc.
Valeur de retour
None
Remarques
Un pilote miniport orienté connexion doit appeler NdisMCoActivateVcComplete si sa fonction MiniportCoActivateVc a précédemment retourné NDIS_STATUS_PENDING en réponse à une demande d’activation ou de réactivation du vc identifié par le NdisVcHandle donné. Le gestionnaire d’appels, qui a lancé l’activation vc avec un appel à NdisCmActivateVc, ne peut pas informer NDIS ou son client si les transferts sur le VC peuvent être effectués à l’aide des paramètres d’appel fournis tant que le pilote miniport n’appelle pas NdisMCoActivateVcComplete.
Si le pilote miniport trouve les paramètres d’appel fournis par CM inacceptables, il échoue à l’activation vc lorsqu’il appelle NdisMCoActivateVcComplete. L’échec de l’activation initiale d’un vc peut entraîner la destruction du protocole qui a créé la vc. Si le pilote miniport échoue à une demande de réactivation d’un vc établi avec de nouveaux paramètres d’appel, il doit restaurer les paramètres d’appel d’origine établis pour ce VC. Selon la nature du support réseau, un pilote miniport peut modifier les paramètres multimédias si les indicateurs de arrondi et/ou d’arrondi sont définis avant d’appeler NdisMCoActivateVcComplete.
Un appel à NdisMCoActivateVcComplete entraîne l’appel de NDIS Fonction ProtocolCmActivateVcComplete du gestionnaire d’appels qui a demandé à l’origine l’activation vc.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (consultez NdisMCoActivateVcComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCoActivateVcComplete (NDIS 5.1)) dans Windows XP. |
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | ndis.h (inclure Ndis.h) |
Bibliothèque | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
Règles de conformité DDI | Irql_MCO_Function(ndis) |