Partager via


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.

Exigences

Exigence Valeur
client minimum pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir 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 Bureau
d’en-tête ndis.h (include Ndis.h)
bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
règles de conformité DDI Irql_MCO_Function(ndis)

Voir aussi

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc

ProtocolCmActivateVcComplete