NdisMCmDeactivateVc, fonction (ndis.h)

Article
03/01/2024

NdisMCmDeactivateVc informe NDIS qu’il n’y aura plus de transferts sur un vc actif particulier.

Syntaxe

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Paramètres

[in] NdisVcHandle

Spécifie le handle identifiant le vc. Ce handle a été fourni par NDIS au pilote MCM, soit lorsqu’il a appelé NdisMCmCreateVc pour un appel entrant, soit quand sa fonction ProtocolCoCreateVc a configuré le vc pour un appel sortant lancé par le client.

Valeur retournée

NdisMCmDeactivateVc peut retourner l’un des éléments suivants :

Code de retour	Description
NDIS_STATUS_SUCCESS	NDIS a marqué le vc comme inactif.
NDIS_STATUS_NOT_ACCEPTED	Le vc est déjà désactivé, de sorte que cet appel est redondant.

Remarques

Un pilote MCM appelle NdisMCmDeactivateVc comme étape essentielle dans la fermeture d’un appel, généralement après l’échange de paquets avec les composants réseau qui détruisent la connexion.

Un appel réussi à NdisMCmDeactivateVc permet au pilote MCM d’ignorer les paramètres d’appel actuels pour les transferts sur le vc, en les réinitialisant éventuellement en valeurs par défaut déterminées par le pilote miniport. Toutefois, si le vc est réactivé par la suite pour un autre appel, le client fournit de nouveaux paramètres d’appel au pilote miniport.

Le NdisVcHandle passé à NdisMCmDeactivateVc reste valide une fois la désactivation de VC terminée. La désactivation de tout vc permet à son créateur de réinitialiser le vc pour le réutiliser ou le détruire :

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, ou il peut appeler NdisCoDeleteVc, provoquant ainsi un appel à la fonction ProtocolCoDeleteVc du pilote MCM.
Après la désactivation de vc et la fermeture de l’appel, un pilote MCM peut réutiliser un vc qu’il a créé à l’origine pour indiquer un autre appel entrant au même client avec NdisMCmDispatchIncomingCall, ou il peut appeler NdisMCmDeleteVc.

L’enregistreur de pilotes détermine si un pilote MCM a une fonction (interne) MiniportCoDeactivateVc que le pilote appelle dans le contexte de l’arrêt des connexions pour les appels sortants et entrants.

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

Configuration requise

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