NdisCmOpenAddressFamilyComplete, fonction (ndis.h)
NdisCmOpenAddressFamilyComplete retourne l’état final d’un gestionnaire d’appels autonome ouvert 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 l’état final 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 'état n’est pas NDIS_STATUS_SUCCESS, NDIS ignore ce paramètre.
Valeur de retour
Aucun
Remarques
Un gestionnaire d’appels autonome doit appeler NdisCmOpenAddressFamilyComplete si sa fonction ProtocolCmOpenAf précédemment retournée NDIS_STATUS_PENDING pour la NdisAfHandle donnée . Le client, qui a lancé l’opération open-AF pendée avec un appel à NdisClOpenAddressFamilyEx, ne peut pas effectuer d’autres opérations orientées connexion sur la même liaison jusqu’à NdisCmOpenAddressFamilyComplete provoque un appel à ce client ProtocolClOpenAfCompleteEx fonction.
Si l’appelant de NdisCmOpenAddressFamilyComplete définit Status sur NDIS_STATUS_SUCCESS, NDIS transmet ensuite la CallMgrAfContext handle en tant que paramètre d’entrée à toutes les fonctions ProtocolCm fournies par CMXxx et ProtocolCoXxx qui concernent l’ouverture de la famille d’adresses du client 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 passer un état d’échec à NdisCmOpenAddressFamilyComplete.
Pour une ouverture réussie, le NDIS fourni NdisAfHandle 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, non modifiée et non interprétée, dans les appels suivants aux fonctions NdisCl/Cm/CoXxx pour lesquelles ce handle est un paramètre requis. Pour une ouverture ayant échoué, le gestionnaire d’appels doit prendre en compte le NdisAfHandle non valide lorsque NdisMCmOpenAddressFamilyComplete retourne le contrôle.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS comme 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.