NdisCmDeactivateVc, fonction (ndis.h)
NdisCmDeactivateVc avertit NDIS et le pilote miniport sous-jacent qu’il n’y aura aucun transfert supplémentaire sur un VC actif particulier.
Syntaxe
NDIS_STATUS NdisCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
Paramètres
[in] NdisVcHandle
Spécifie le handle identifiant le vc. Ce handle a été fourni par NDIS au gestionnaire d’appels lorsqu’il a appelé NdisCoCreateVc pour un appel entrant ou lorsque sa fonction ProtocolCoCreateVc configure la vc pour un appel sortant initié par le client.
Valeur de retour
Lorsque NdisCmDeactivateVc retourne autre chose que NDIS_STATUS_PENDING, le gestionnaire d’appels doit effectuer un appel interne à son ProtocolCmDeactivateVcComplete function. Dans le cas contraire, NDIS appelle la fonction ProtocolCmDeactivateVcComplete cm lorsque cette opération est terminée.
Remarques
Un gestionnaire d’appels autonome appelle NdisCmDeactivateVc comme étape essentielle de la fermeture d’un appel, généralement après l’échange de paquets avec les composants réseau qui suppriment l’appel.
Un appel à NdisCmDeactivateVc permet à NDIS d’appeler la fonction MiniportCoDeactivateVc sous-jacente du pilote miniport, qui peut ignorer les paramètres d’appel actuels pour les transferts sur la vc, éventuellement les réinitialiser aux valeurs par défaut déterminées par le pilote miniport. Si le vc est réactivé par la suite pour un autre appel, le client ou le gestionnaire d’appels fournit de nouveaux paramètres d’appel au pilote miniport.
Le NdisVcHandle passé à NdisCmDeactivateVc reste valide une fois la désactivation vc terminée. La désactivation de n’importe quelle vc permet à son créateur de réinitialiser la vc à réutiliser :
- Après la désactivation vc et la fermeture de l’appel, un client peut réutiliser un vc qu’il a créé à l’origine pour effectuer un autre appel avec NdisClMakeCall.
- Après la désactivation vc et la fermeture de l’appel, un CM peut réutiliser un vc qu’il a créé à l’origine pour indiquer un autre appel entrant au même client avec NdisCmDispatchIncomingCall.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmDeactivateVc. Pilotes miniport orientés connexion qui fournissent un appel de support intégré de gestion des appels NdisMCmDeactivateVc à la place.