Partager via


Fonction NdisCoDeleteVc (ndis.h)

NdisCoDeleteVc détruit un vc créé par l’appelant.

Syntaxe

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Paramètres

[in] NdisVcHandle

Spécifie le handle identifiant le vc à supprimer. L’appelant a initialement obtenu ce handle à partir de NdisCoCreateVc.

Valeur retournée

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

Code de retour Description
NDIS_STATUS_SUCCESS
NDIS a supprimé le vc.
NDIS_STATUS_NOT_ACCEPTED
Le VC étant toujours actif, il n’a pas pu être supprimé.
NDIS_STATUS_CLOSING
Cet appel est redondant, mais la désactivation sur le vc donné est toujours en attente.

Remarques

Lorsqu’un protocole appelle NdisCoDeleteVc, il ne doit pas y avoir d’appels en suspens sur le vc donné et ce vc a déjà été désactivé. Pour répondre à ces exigences, les conditions suivantes sont remplies :

  • Si la désactivation de l’appel a été lancée par un client local, ce client a déjà appelé NdisClCloseCall avec le NdisVcHandle donné et sa demande d’appel de fermeture s’est terminée avec succès.
  • Si la suppression de l’appel a été lancée par un client distant, le gestionnaire d’appels autonome a déjà appelé NdisCmDeactivateVc avec le NdisVcHandle donné et sa demande de désactivation s’est terminée avec succès.
Seul le protocole qui a créé un vc particulier peut supprimer cette vc. Un appel à NdisCoDeleteVc amène NDIS à appeler à la fois la fonction MiniportCoDeleteVc du pilote miniport sous-jacent et la fonction ProtocolCoDeleteVc du client ou du gestionnaire d’appels avec lequel l’appelant partage le NdisVcHandle .

Lorsque NdisCoDeleteVc retourne le contrôle, le NdisVcHandle n’est plus valide.

Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCoDeleteVc. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent À la place NdisMCmDeleteVc .

Configuration requise

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

Voir aussi

MiniportCoDeleteVc

NdisClCloseCall

NdisCmDeactivateVc

NdisCoCreateVc

NdisMCmDeleteVc

ProtocolClCloseCallComplete

ProtocolClIncomingCloseCall

ProtocolCmCloseCall

ProtocolCoDeleteVc