NdisMCmDeactivateVc, fonction (ndis.h)
NdisMCmDeactivateVc avertit NDIS qu’il n’y aura pas de transferts supplémentaires 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 ou lorsque sa fonction ProtocolCoCreateVc configure la vc pour un appel sortant initié par le client.
Valeur de retour
NdisMCmDeactivateVc pouvez retourner l’une des options suivantes :
| Retourner le code | Description |
|---|---|
|
NDIS a marqué le vc comme inactif. |
|
Le vc est déjà désactivé. Cet appel est donc redondant. |
Remarques
Un pilote MCM appelle NdisMCmDeactivateVc comme étape essentielle pour fermer un appel, généralement après l’échange de paquets avec les composants réseau qui suppriment la connexion.
Un appel réussi à NdisMCmDeactivateVc permet au pilote MCM d’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. Toutefois, si la vc est réactivée 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 vc terminée. La désactivation de n’importe quelle vc permet à son créateur de réinitialiser le vc à réutiliser ou de le détruire :
- 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, ou il peut appeler NdisCoDeleteVc, provoquant ainsi un appel à la fonction ProtocolCoDeleteVc du pilote MCM.
- Après la désactivation 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.
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 auprès de NDIS comme pilotes de protocole, appellent NdisCmDeactivateVc à la place.