NdisClOpenAddressFamilyEx, fonction (ndis.h)

Article
08/07/2023

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 retourné par NdisOpenAdapterEx et qui identifie le carte d’interface réseau cible ou la carte virtuelle du pilote inférieur suivant auquel l’appelant est lié.

[in] AddressFamily

Pointeur vers une structure de 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 Fonction ProtocolCoAfRegisterNotify , qui appelle NdisClOpenAddressFamilyEx.

[in] ClientAfContext

Handle d’une zone de contexte résident fournie par l’appelant dans laquelle le client maintient l’état de cet 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 retournée

Lorsque NdisClOpenAddressFamilyEx retourne autre chose que NDIS_STATUS_PENDING, le client doit effectuer un appel interne à son Fonction ProtocolClOpenAfCompleteEx . Sinon, NDIS appelle la fonction ProtocolClOpenAfCompleteEx du client lorsque cette opération est terminée.

Remarques

Un client CoNDIS appelle NdisClOpenAddressFamilyEx à partir de son Fonction ProtocolCoAfRegisterNotify , 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, qui garantit que le client a passé une structure AF valide.

Un appel réussi à NdisClOpenAddressFamilyEx configure la communication entre le client et 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’il 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 à l’adaptateur miniport sous-jacent. Sinon, le client doit enregistrer le handle retourné au niveau du paramètre NdisAfHandle . Ce handle identifie le gestionnaire d’appels vers lequel 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 passant sans modification et non interprété dans les appels de fonction NdisXxx suivants.

NDIS transmet le pointeur du paramètre ClientAfContext aux fonctions ProtocolClXxx inscrites du client dans tous les appels suivants qui concernent af jusqu’à ce que le client appelle NdisClCloseAddressFamily avec le même NdisAfHandle . Une fois l’af-af fermé, le client peut libérer ou réutiliser le stockage qu’il a alloué dans ClientAfContext .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Protocol_Driver_Function(ndis)