NdisMCmActivateVc, fonction (ndis.h)
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 par l’appelant, mise en forme sous forme de structure de type CO_CALL_PARAMETERS, contenant tous les paramètres spécifiques au média que le pilote miniport utilise pour la vc activée.
Valeur de retour
Lorsque NdisMCmActivateVc retourne autre chose que NDIS_STATUS_PENDING, le pilote MCM doit effectuer un appel interne à son ProtocolCmActivateVcComplete fonction. 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é les paramètres d’appel et de média sur un vc nouvellement créé ou 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 toutes les données ne soient envoyées ou reçues sur cette vc. Cet appel informe NDIS que le pilote miniport a fait une carte réseau prête pour les transferts sur la vc.
Pour un appel sortant initié par le client, un pilote MCM appelle généralement NdisMCmActivateVc suivant l’établissement d’une négociation 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 des appels sortants avec NdisMCmMakeCallComplete. Pour un appel entrant, un pilote MCM appelle généralement NdisMCmActivateVc une fois qu’il a appelé NdisMCmCreateVc correctement et avant d’appeler NdisMCmDispatchIncomingCall.
L’enregistreur de pilotes détermine si un pilote MCM a un MiniportCoActivateVc fonction 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 le changement réseau et/ou chaque fois que le client appelle NdisClModifyCallQoS. Le pilote MCM doit mettre à jour l’état qu’il conserve sur les paramètres d’appel vers les nouvelles valeurs s’il peut continuer à effectuer des transferts sur la vc en fonction des paramètres d’appel nouvellement modifiés. Il doit appeler NdisMCmActivateVc pour informer NDIS des modifications apportées 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 l’échec de la requête du client pour modifier QoS ou d’autres paramètres d’appel pour la vc à un tel état que le pilote miniport ne peut pas continuer à effectuer des transferts sur la vc.
- Restaurez les paramètres d’appel dans 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 la 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.