Partager via


NdisCmActivateVc, fonction (ndis.h)

NdisCmActivateVc passe les paramètres d’appel fournis par CM, y compris les paramètres multimédias, pour une vc particulière jusqu’au pilote miniport sous-jacent.

Syntaxe

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

Paramètres

[in] NdisVcHandle

Spécifie le handle identifiant le vc sur lequel définir les paramètres d’appel. Le gestionnaire d’appels a obtenu ce handle à partir de NdisCoCreateVc pour un appel entrant ou en tant que paramètre d’entrée à sa fonction ProtocolCoCreateVc pour un appel sortant initié par le client.

[in, out] CallParameters

Pointeur vers une mémoire tampon résidente allouée par CM, mise en forme sous forme de structure de type CO_CALL_PARAMETERS, contenant tous les paramètres spécifiques au support que le pilote miniport sous-jacent utilise pour l’activation vc.

Valeur de retour

Lorsque NdisCmActivateVc retourne autre chose que NDIS_STATUS_PENDING, le gestionnaire d’appels doit effectuer un appel interne à son ProtocolCmActivateVcComplete fonction. Sinon, NDIS appelle la fonction ProtocolCmActivateVcComplete cm à la fin de cette opération.

Remarques

NdisCmActivateVc avertit le pilote miniport sous-jacent de configurer les paramètres d’appel et de média sur un vc nouvellement créé ou de modifier ceux d’un vc établi. NDIS transfère les paramètres d’appel et le handle VC donnés à la fonction MiniportCoActivateVc sous-jacente du pilote MiniportCoActivateVc, qui configure toutes les ressources nécessaires pour suivre l’état de la vc et se rend ainsi qu’une carte réseau prête pour les transferts de données sur la vc.

Une cm autonome appelle toujours NdisCmActivateVc après l’établissement d’une connexion sur un VC, mais avant que toutes les données ne soient envoyées ou reçues sur cette vc. Pendant la durée de la connexion, une cm peut appeler NdisCmActivateVc plusieurs fois avec le même NdisVcHandle que les conditions sur le changement réseau et/ou chaque fois que le client appelle NdisClModifyCallQoS. À chaque appel de ce type à NdisCmActivateVc, la fonction miniport du pilote miniport sous-jacent doit effectuer l’une des opérations suivantes :

  • Mettez à jour l’état que le pilote miniport conserve sur les paramètres d’appel vers les nouvelles valeurs fournies par le gestionnaire d’appels si le pilote miniport peut continuer à effectuer des transferts sur le vc en fonction des paramètres d’appel nouvellement modifiés.
  • Échec de l’appel si le pilote miniport ne peut pas continuer à effectuer des transferts sous les contraintes des paramètres d’appel donnés.
Lorsque le pilote miniport sous-jacent échoue à une demande de définition ou de réinitialisation des paramètres d’appel, le gestionnaire d’appels peut modifier sa spécification d’origine à CallParameters et appeler NdisCmActivateVc à nouveau. La limite du nombre de fois où un gestionnaire d’appels effectue des tentatives répétées d’activation d’une vc dépend de l’implémentation.

Pour un appel sortant initié par le client, un CM autonome appelle généralement NdisCmActivateVc immédiatement après l’échange de paquets confirmant un accord négocié avec la cible distante de l’appel ou la configuration réussie de l’appel au commutateur, avant qu’il avertit NDIS (et le client) de la saisie semi-automatique des appels sortants avec NdisCmMakeCallComplete. Pour un appel entrant, un gestionnaire d’appels appelle généralement NdisCmActivateVc une fois qu’il a appelé NdisCoCreateVc correctement et avant d’appeler NdisCmDispatchIncomingCall.

Dans le processus de configuration d’un appel sortant et pendant l’activation de n’importe quelle vc, le client peut demander des modifications aux paramètres d’appel de cette vc, par exemple en appelant NdisClModifyCallQos. Après avoir vérifié la validité des paramètres d’appel donnés pour une telle demande, le gestionnaire d’appels autonome doit appeler NdisCmActivateVc pour transmettre les paramètres d’appel modifiés au pilote miniport sous-jacent.

Seuls les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmActivateVc. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels NdisMCmActivateVc à la place.

Exigences

Exigence Valeur
client minimum pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisCmActivateVc (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisCmActivateVc (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_CallManager_Function(ndis)

Voir aussi

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisClMakeCall

NdisClModifyCallQos

NdisCmDeactivateVc

NdisCmDispatchIncomingCall

NdisCoCreateVc

NdisMCmActivateVc

ProtocolCmActivateVcComplete

ProtocolCoCreateVc