Partager via


Fonction NdisMCmDeleteVc (ndis.h)

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

Syntaxe

NDIS_STATUS NdisMCmDeleteVc(
  [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 NdisMCmCreateVc.

Valeur retournée

NdisMCmDeleteVc 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é.

Remarques

Lorsqu’un pilote MCM appelle NdisMCmDeleteVc, il ne doit y avoir aucun appel en suspens sur le VC donné et ce vc doit avoir été désactivé. Pour répondre à ces exigences, le pilote MCM a déjà appelé NdisMCmDeactivateVc avec le NdisVcHandle donné.

Seul le pilote qui a créé un vc particulier peut supprimer cette VC. Un appel à NdisMCmDeleteVc amène NDIS à appeler la fonction ProtocolCoDeleteVc du client avec lequel l’appelant partage le NdisVcHandle .

Lorsque NdisMCmDeleteVc retourne le contrôle, le NdisVcHandle n’est plus valide. Le pilote MCM peut libérer les ressources qu’il a allouées pour maintenir l’état du VC supprimé ou les préparer à une réutilisation dans une notification d’appel entrante ultérieure après avoir appelé NdisMCmCreateVc.

L’enregistreur de pilotes détermine si un pilote MCM a une fonction MiniportCoDeleteVc (interne) que le pilote appelle dans le contexte de la destruction 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 NdisMCmDeleteVc. Les gestionnaires d’appels et les clients autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCoDeleteVc .

Configuration requise

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

Voir aussi

MiniportCoDeleteVc

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCreateVc

NdisMCmDeactivateVc

ProtocolCoDeleteVc