NdisCmOpenAddressFamilyComplete, fonction (ndis.h)

  • Article

NdisCmOpenAddressFamilyComplete retourne la status finale de l’ouverture d’un gestionnaire d’appels autonome d’un af donné pour un client particulier après que le gestionnaire d’appels a retourné NDIS_STATUS_PENDING en réponse à la demande open-AF d’origine de ce client.

Syntaxe

void NdisCmOpenAddressFamilyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisAfHandle,
  [in] NDIS_HANDLE CallMgrAfContext
);

Paramètres

[in] Status

Spécifie la status finale de l’opération open-AF, NDIS_STATUS_SUCCESS ou toute erreur déterminée par CM NDIS_STATUS_ XXX, sauf NDIS_STATUS_PENDING.

[in] NdisAfHandle

Spécifie le handle fourni par NDIS qui a été entré dans la fonction ProtocolCmOpenAf du gestionnaire d’appels, qui a retourné NDIS_STATUS_PENDING.

[in] CallMgrAfContext

Spécifie le handle d’une zone de contexte résident allouée par l’appelant dans laquelle le gestionnaire d’appels conserve l’état de l’ouverture de la famille d’adresses de ce client, y compris le NdisAfHandle, si l’ouverture a réussi. Si Status n’est pas NDIS_STATUS_SUCCESS, NDIS ignore ce paramètre.

Valeur de retour

None

Remarques

Un gestionnaire d’appels autonome doit appeler NdisCmOpenAddressFamilyComplete si sa fonction ProtocolCmOpenAf a précédemment renvoyé NDIS_STATUS_PENDING pour le NdisAfHandle donné. Le client, qui a lancé l’opération open-AF avec un appel à NdisClOpenAddressFamilyEx, ne peut pas effectuer d’autres opérations orientées connexion sur la même liaison tant que NdisCmOpenAddressFamilyComplete n’a pas provoqué un appel à ce client Fonction ProtocolClOpenAfCompleteEx .

Si l’appelant de NdisCmOpenAddressFamilyComplete définit Status sur NDIS_STATUS_SUCCESS, NDIS transmet ensuite le handle CallMgrAfContext donné en tant que paramètre d’entrée à toutes les fonctions ProtocolCmXxx et ProtocolCoXxx fournies par CM qui concernent l’ouverture du client de la famille d’adresses jusqu’à ce que le client ferme l’AF. Le gestionnaire d’appels doit libérer ou réutiliser toute zone de contexte AF qu’il a allouée avant de transmettre un échec status à NdisCmOpenAddressFamilyComplete.

Pour une ouverture réussie, le NdisAfHandle fourni par NDIS représente une association entre le gestionnaire d’appels et le client pour l’af ouvert sur un pilote miniport particulier auquel le gestionnaire d’appels et le client sont liés. Les deux pilotes de protocole doivent traiter NdisAfHandle comme une variable opaque à passer, sans modification et sans interprétation, dans les appels suivants aux fonctions NdisCl/Cm/CoXxx pour lesquelles ce handle est un paramètre obligatoire. En cas d’échec de l’ouverture, le gestionnaire d’appels doit considérer le NdisAfHandle non valide lorsque NdisMCmOpenAddressFamilyComplete retourne le contrôle.

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

Configuration requise

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

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisMCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf