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 soit lorsqu’il a appelé NdisCoCreateVc pour un appel entrant ou lorsque sa fonction ProtocolCoCreateVc configure le VC pour un appel sortant initié par le client.

Valeur de retour

Lorsque NdisCmDeactivateVc retourne quelque chose d’autre que NDIS_STATUS_PENDING, le gestionnaire d’appels doit effectuer un appel interne à son Fonction ProtocolCmDeactivateVcComplete . Sinon, NDIS appelle la fonction ProtocolCmDeactivateVcComplete de la CM lorsque cette opération est terminée.

Remarques

Un gestionnaire d’appels autonome appelle NdisCmDeactivateVc comme étape essentielle de 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 du pilote miniport sous-jacent, qui peut ignorer les paramètres d’appel actuels pour les transferts sur le VC, éventuellement les réinitialiser à 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 quel VC permet à son créateur de réinitialiser le VC pour réutilisation :

  • 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.
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 comme pilotes de protocole, peuvent appeler NdisCmDeactivateVc. Pilotes miniport orientés connexion qui fournissent plutôt un support intégré de gestion des appels NdisMCmDeactivateVc à la place.

Configuration requise

   
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 (voir NdisCmDeactivateVc (NDIS 5.1)) dans Windows XP.
Plateforme cible Desktop (Expérience utilisateur)
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

MiniportCoDeactivateVc

NdisClCloseCall

NdisClMakeCall

NdisCmActivateVc

NdisCmDispatchIncomingCall

NdisMCmDeactivateVc

ProtocolCmCloseCall

ProtocolCmDeactivateVcComplete