Macro NdisMCmOpenAddressFamilyComplete (ndis.h)
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) |