Macro NdisMCmCloseCallComplete (ndis.h)

Article
02/29/2024

NdisMCmCloseCallComplete retourne la dernière status de la demande d’un client, pour laquelle le pilote MCM a précédemment renvoyé NDIS_STATUS_PENDING, pour supprimer un appel.

Syntaxe

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

Paramètres

_S_

Spécifie la status finale de la demande du client pour que le pilote MCM ferme la connexion, soit NDIS_STATUS_SUCCESS, soit tout NDIS_STATUS_XXX déterminé par l’appelant, sauf NDIS_STATUS_PENDING.

_VH_

Spécifie le handle du vc pour l’appel. Ce handle a été fourni par NDIS lors de la création initiale du vc, que ce soit par le pilote MCM avec NdisMCmCreateVc ou en tant que paramètre d’entrée pour sa fonction ProtocolCoCreateVc .

_PH_

Spécifie null si le NdisVcHandle représente un vc point à point ou le handle du dernier tiers restant sur une connexion multipoint, que le pilote MCM a obtenu à partir de son état par partie désigné par le CallMgrPartyContext passé en tant que paramètre d’entrée à son Fonction ProtocolCmCloseCall .

Valeur de retour

None

Remarques

Si la fonction ProtocolCmCloseCall d’un pilote MCM retourne NDIS_STATUS_PENDING, elle doit appeler NdisMCmCloseCallComplete par la suite pour informer le client et NDIS que sa tentative d’arrêt de la connexion est terminée, que ce soit avec succès ou avec une erreur. Un appel à NdisMCmCloseCallComplete amène NDIS à appeler la fonction ProtocolClCloseCallComplete du client.

S’il transmet NDIS_STATUS_SUCCESS comme État, le pilote MCM doit considérer le NdisVcHandle (et le cas échéant NdisPartyHandle) inutilisable pour les transferts sur le réseau dès qu’il appelle NdisMCmCloseCallComplete. Si le pilote MCM a initialement créé le vc, il doit appeler NdisMCmDeleteVc avec le même NdisVcHandle qu’il vient de passer à NdisMCmCloseCallComplete. Si le client a créé ce vc, le pilote MCM peut s’attendre à un appel à sa fonction ProtocolCoDeleteVc avec le
ProtocolVcContext, désignant son état par vc dans lequel il a stocké le même NdisVcHandle, en tant que paramètre d’entrée.

Seuls les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels peuvent appeler NdisMCmCloseCallComplete. Les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCmCloseCallComplete .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmCloseCallComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmCloseCallComplete (NDIS 5.1)) dans Windows XP.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_MCM_Function(ndis)