NdisClOpenAddressFamilyEx, fonction (ndis.h)
La fonction NdisClOpenAddressFamilyEx inscrit une famille d’adresses (AF) associée à un gestionnaire d’appels pour un client orienté connexion.
Syntaxe
NDIS_STATUS NdisClOpenAddressFamilyEx(
[in] NDIS_HANDLE NdisBindingHandle,
[in] PCO_ADDRESS_FAMILY AddressFamily,
[in] NDIS_HANDLE ClientAfContext,
[out] PNDIS_HANDLE NdisAfHandle
);
Paramètres
[in] NdisBindingHandle
Handle qui NdisOpenAdapterEx retourne et qui identifie la carte d’interface réseau cible (NIC) ou la carte virtuelle du pilote inférieur suivant auquel l’appelant est lié.
[in] AddressFamily
Pointeur vers une structure CO_ADDRESS_FAMILY qui décrit le gestionnaire d’appels et AF à ouvrir.
Ce pointeur est un paramètre d’entrée vers le client ProtocolCoRegisterNotify fonction, qui appelle NdisClOpenAddressFamilyEx.
[in] ClientAfContext
Handle vers une zone de contexte résident fournie par l’appelant dans laquelle le client conserve l’état de cette af après l’ouverture de l’AF. NDIS transmet ce handle au client dans tous les appels suivants concernant cet AF si l’appel à NdisClOpenAddressFamilyEx réussit.
[out] NdisAfHandle
Pointeur vers une variable fournie par l’appelant dans laquelle NdisClOpenAddressFamilyEx retourne un handle qui représente la famille d’adresses nouvellement ouverte.
Valeur de retour
Lorsque NdisClOpenAddressFamilyEx retourne quelque chose d’autre que NDIS_STATUS_PENDING, le client doit effectuer un appel interne à son ProtocolClOpenAfCompleteEx fonction. Sinon, NDIS appelle la fonction ProtocolClOpenAfCompleteEx du client une fois cette opération terminée.
Remarques
Un client CoNDIS appelle NdisClOpenAddressFamilyEx à partir de son ProtocolCoRegisterNotify fonction, une fois que le client a vérifié la mémoire tampon d’entrée pointée par le paramètre AddressFamily pour déterminer si le client reconnaît le gestionnaire d’appels et les adresses inscrites. NDIS transfère l’appel du client de NdisClOpenAddressFamilyEx à la fonction ProtocolCmOpenAf du gestionnaire d’appels, ce qui garantit que le client a transmis une structure AF valide.
Un appel réussi à NdisClOpenAddressFamilyEx configure la communication du client vers un gestionnaire d’appels. Le client peut ensuite se préparer à recevoir des appels entrants en appelant la fonction NdisClRegisterSap. Le client peut également configurer une connexion virtuelle (VC) en appelant la fonction NdisCoCreateVc afin qu’elle puisse effectuer un appel sortant en appelant la fonction NdisClMakeCall.
Si l’appel du client à NdisClOpenAddressFamilyEx échoue, le client doit appeler la fonction NdisUnbindAdapter pour demander à NDIS de libérer sa liaison sur l’adaptateur miniport sous-jacent. Sinon, le client doit enregistrer le handle retourné au paramètre NdisAfHandle. Ce handle identifie le gestionnaire d’appels auquel les demandes suivantes concernant la famille d’adresses donnée sont dirigées. Le client doit traiter ce handle retourné comme une variable opaque, en le transmettant non modifié et non interprété dans les appels de fonction NdisXxx.
NDIS transmet le pointeur du paramètre ClientAfContext au paramètre ProtocolClXxx inscrit du client dans tous les appels suivants qui concernent l’AF jusqu’à ce que le client appelle NdisClCloseAddressFamily avec le même NdisAfHandle. Une fois l’AF fermé, le client peut libérer ou réutiliser le stockage qu’il a alloué à ClientAfContext.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | Irql_Protocol_Driver_Function(ndis) |