Macro NdisMCmOpenAddressFamilyComplete (ndis.h)

  • Article

NdisMCmOpenAddressFamilyComplete retourne la status finale de la demande d’un client, pour laquelle la fonction ProtocolCmOpenAf du pilote MCM a retournée NDIS_STATUS_PENDING, pour ouvrir la famille d’adresses du pilote MCM.

Syntaxe

void NdisMCmOpenAddressFamilyComplete(
   _S_,
   _H_,
   _C_
);

Paramètres

_S_

Spécifie la status finale de la demande du client d’ouvrir l’AF, soit NDIS_STATUS_SUCCESS, soit n’importe quel NDIS_STATUS_ XXX déterminé par l’appelant, sauf NDIS_STATUS_PENDING.

_H_

Spécifie le handle fourni par NDIS qui a été entré dans la fonction ProtocolCmOpenAf du pilote MCM, qui a retourné NDIS_STATUS_PENDING.

_C_

Spécifie le handle d’une zone de contexte résident allouée par l’appelant, dans laquelle le pilote MCM conserve l’état de l’ouverture de ce client de la famille d’adresses, y compris le NdisAfHandle, si l’ouverture a réussi. Sinon, NDIS ignore ce paramètre.

Valeur de retour

None

Remarques

Un pilote MCM doit appeler NdisMCmOpenAddressFamilyComplete 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 NdisMCmOpenAddressFamilyComplete ne provoque pas un appel à ce client Fonction ProtocolClOpenAfCompleteEx .

Si l’appelant de NdisMCmOpenAddressFamilyComplete 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 le pilote MCM qui concernent l’ouverture du client de la famille d’adresses jusqu’à ce que le client ferme l’AF. Le pilote MCM doit libérer ou réutiliser toute zone de contexte AF qu’il a allouée avant de transmettre un échec status à NdisMCmOpenAddressFamilyComplete.

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

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

Configuration requise

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

Voir aussi

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf