Fonction NdisCoDeleteVc (ndis.h)

Article
02/29/2024

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)