NdisMCmActivateVc, fonction (ndis.h)

Article
02/29/2024

NdisMCmActivateVc informe NDIS qu’un pilote MCM est prêt à effectuer des transferts sur un vc particulier.

Syntaxe

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Paramètres

[in] NdisVcHandle

Spécifie le handle identifiant le vc.

[in] CallParameters

Pointeur vers une mémoire tampon allouée à l’appelant, mise en forme en tant que structure de type CO_CALL_PARAMETERS, contenant tous les paramètres spécifiques au média que le pilote miniport utilise pour le vc activé.

Valeur retournée

Lorsque NdisMCmActivateVc retourne autre chose que NDIS_STATUS_PENDING, le pilote MCM doit effectuer un appel interne à son Fonction ProtocolCmActivateVcComplete . Sinon, NDIS appelle la fonction ProtocolCmActivateVcComplete du pilote MCM lorsque cette opération est terminée.

Remarques

NdisMCmActivateVc informe NDIS qu’un pilote MCM a configuré des paramètres d’appel et de média sur un vc nouvellement créé ou a modifié les paramètres d’appel sur un vc établi.

Un pilote MCM doit appeler NdisMCmActivateVc après avoir établi une connexion sur un vc, mais avant que des données ne soient envoyées ou reçues sur ce vc. Cet appel informe NDIS que le pilote miniport a rendu une carte réseau prête pour les transferts sur le vc.

Pour un appel sortant initié par le client, un pilote MCM appelle généralement NdisMCmActivateVc après l’établissement d’une liaison indiquant un accord négocié avec le nœud distant ou une configuration d’appel réussie au niveau du commutateur, avant d’avertir NDIS (et le client) de l’achèvement de l’appel sortant avec NdisMCmMakeCallComplete. Pour un appel entrant, un pilote MCM appelle généralement NdisMCmActivateVc après avoir appelé NdisMCmCreateVc avec succès et avant d’appeler NdisMCmDispatchIncomingCall.

L’enregistreur de pilotes détermine si un pilote MCM a une fonction MiniportCoActivateVc (interne) que le pilote appelle dans le contexte de la configuration des connexions pour les appels sortants et entrants.

Pendant la durée de la connexion, un pilote MCM peut modifier les paramètres d’appel en tant que conditions sur la modification du réseau et/ou chaque fois que le client appelle NdisClModifyCallQoS. Le pilote MCM doit mettre à jour l’état qu’il maintient sur les paramètres d’appel sur les nouvelles valeurs s’il peut continuer à effectuer des transferts sur le vc en fonction des paramètres d’appel nouvellement modifiés. Il doit appeler NdisMCmActivateVc pour notifier NDIS de toute modification apportée aux paramètres d’appel pour le vc actif. Sinon, le pilote MCM peut effectuer l’une des opérations suivantes :

Appelez NdisMCmDeactivateVc après avoir échoué à la demande du client de modifier qoS ou d’autres paramètres d’appel pour le vc à un état tel que le pilote miniport ne peut pas continuer à effectuer des transferts sur le vc.
Restaurez les paramètres d’appel à un état précédemment accepté, informez le client qui a demandé la modification et restez prêt à continuer à transférer des données sur le vc. Dans ce cas, le client a la possibilité d’accepter les paramètres d’appel restaurés ou de les rejeter et de lancer une fermeture du vc.

Seuls les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels peuvent appeler NdisMCmActivateVc. Les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCmActivateVc .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmActivateVc (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmActivateVc (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_MCM_Function(ndis)