NdisCmDeactivateVc, fonction (ndis.h)
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.
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) |