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 a supprimé le vc. |
|
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) |