NdisCmDeactivateVc, fonction (ndis.h)

Article
03/01/2024

NdisCmDeactivateVc avertit NDIS et le pilote miniport sous-jacent qu’il n’y aura pas d’autres transferts 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 soit lorsqu’il a appelé NdisCoCreateVc pour un appel entrant, soit lorsque sa fonction ProtocolCoCreateVc a configuré le vc pour un appel sortant initié par le client.

Valeur retournée

Lorsque NdisCmDeactivateVc retourne autre chose que NDIS_STATUS_PENDING, le gestionnaire d’appels doit effectuer un appel interne à son Fonction ProtocolCmDeactivateVcComplete . Sinon, NDIS appelle la fonction ProtocolCmDeactivateVcComplete du 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 déchirent l’appel.

Un appel à NdisCmDeactivateVc amène NDIS à appeler la fonction MiniportCoDeactivateVc du pilote miniport sous-jacent, ce qui peut ignorer les paramètres d’appel actuels pour les transferts sur le VC, les réinitialisant éventuellement à des 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 le VC pour la réutiliser :

Après la désactivation de 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 de 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.

Le créateur d’un vc particulier qui ne sera pas réutilisé appelle NdisCoDeleteVc pour détruire ce vc.

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

Configuration requise

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