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.
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.