Partager via


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.
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. Pilotes miniport orientés connexion qui fournissent un appel de support intégré de gestion des appels NdisMCmDeactivateVc à la place.

Exigences

Exigence Valeur
client minimum 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 Bureau
d’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