NdisMCmDeleteVc, fonction (ndis.h)
NdisMCmDeleteVc détruit une vc créée par l’appelant.
Syntaxe
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
Paramètres
[in] NdisVcHandle
Spécifie le handle identifiant la vc à supprimer. L’appelant a obtenu à l’origine ce handle à partir de NdisMCmCreateVc.
Valeur de retour
NdisMCmDeleteVc peut retourner l’une des options suivantes :
| Retourner le code | Description |
|---|---|
|
NDIS a supprimé le vc. |
|
Le vc est toujours actif, de sorte qu’il n’a pas pu être supprimé. |
Remarques
Lorsqu’un pilote MCM appelle NdisMCmDeleteVc, il ne doit pas y avoir d’appels en attente sur le vc donné et que vc doit avoir été désactivé. Pour répondre à ces exigences, le pilote MCM a déjà appelé NdisMCmDeactivateVc avec le NdisVcHandle donné correctement.
Seul le pilote qui a créé un vc particulier peut supprimer ce vc. Un appel à NdisMCmDeleteVc entraîne l’appel de la fonction ProtocolCoDeleteVc du client avec laquelle 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 sur la vc supprimée ou les préparer à une réutilisation dans une notification d’appel entrant ultérieure après qu’il appelle NdisMCmCreateVc.
L’enregistreur de pilotes détermine si un pilote MCM a un MiniportCoDeleteVc fonction que le pilote appelle dans le contexte de la suppression 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 comme pilotes de protocole, appellent NdisCoDeleteVc à la place.