NdisCmCloseCallComplete, fonction (ndis.h)

  • Article

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

Syntaxe

void NdisCmCloseCallComplete(
  [in]           NDIS_STATUS Status,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] NDIS_HANDLE NdisPartyHandle
);

Paramètres

[in] Status

Spécifie le status final de la demande du client de fermer la connexion, soit NDIS_STATUS_SUCCESS, soit n’importe quel NDIS_STATUS_XXX déterminé par cm, sauf NDIS_STATUS_PENDING.

[in] NdisVcHandle

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 gestionnaire d’appels ou le client, avec NdisCoCreateVc. Plus récemment, le gestionnaire d’appels a obtenu ce handle à partir de son état par vc désigné par le CallMgrVcContext passé en tant que paramètre d’entrée à son Fonction ProtocolCmCloseCall .

[in, optional] NdisPartyHandle

Spécifie null si le NdisVcHandle représente un vc point à point ou le handle de la dernière partie restante sur une connexion multipoint, que le cm a obtenu à partir de son état par partie désigné par le CallMgrPartyContext passé en tant que paramètre d’entrée à sa fonction ProtocolCmCloseCall .

Valeur de retour

None

Remarques

Si la fonction ProtocolCmCloseCall d’un gestionnaire d’appels autonome retourne NDIS_STATUS_PENDING, le cm doit appeler NdisCmCloseCallComplete 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 à NdisCmCloseCallComplete amène NDIS à appeler le client Fonction ProtocolClCloseCallComplete .

S’il passe NDIS_STATUS_SUCCESS comme État, le gestionnaire d’appels doit considérer le NdisVcHandle (et le cas échéant NdisPartyHandle) inutilisable pour les transferts sur le réseau dès qu’il appelle NdisCmCloseCallComplete. Si le gestionnaire d’appels a créé le vc à l’origine, il doit appeler NdisCoDeleteVc avec le même NdisVcHandle qu’il vient de passer à NdisCmCloseCallComplete. Si le client a créé ce vc, le gestionnaire d’appels peut s’attendre à un appel à sa fonction ProtocolCoDeleteVc avec le
ProtocolVcContext, où il a le même NdisVcHandle, comme paramètre d’entrée.

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

Configuration requise

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

Voir aussi

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCloseCallComplete

ProtocolClCloseCallComplete

ProtocolCoDeleteVc