Fonction NdisMCoActivateVcComplete (ndis.h)

Article
02/26/2024

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)

Voir aussi

ProtocolCmActivateVcComplete