NdisCmNotifyCloseAddressFamily, fonction (ndis.h)

La fonction NdisCmNotifyCloseAddressFamily avertit NDIS qu’un gestionnaire d’appels se dissocie d’un adaptateur miniport sous-jacent et que tous les clients CoNDIS associés doivent fermer la famille d’adresses (AF) spécifiée.

Syntaxe

NDIS_STATUS NdisCmNotifyCloseAddressFamily(
  [in] NDIS_HANDLE NdisAfHandle
);

Paramètres

[in] NdisAfHandle

Un handle NDIS qui identifie l’AF que NDIS doit fermer. NDIS a fourni ce handle à la fonction ProtocolCmOpenAf du gestionnaire d’appels.

Valeur retournée

NdisCmNotifyCloseAddressFamily peut retourner l’un des éléments suivants :

Code de retour Description
NDIS_STATUS_SUCCESS
NDIS a correctement fermé la famille d’adresses.
NDIS_STATUS_PENDING
NDIS gère cette requête de façon asynchrone et appelle le gestionnaire d’appels Fonction ProtocolCmNotifyCloseAfComplete lorsque l’opération de fermeture est terminée.
NDIS_STATUS_XXX
NDIS a échoué à la demande pour une raison NDIS ou déterminée par le pilote client.

Remarques

Gestionnaires d’appels CoNDIS autonomes, qui s’inscrivent en tant que pilotes de protocole NDIS en appelant le La fonction NdisRegisterProtocolDriver peut appeler la fonction NdisCmNotifyCloseAddressFamily . Les gestionnaires d’appels miniport (MCM) appellent plutôt le Fonction NdisMCmNotifyCloseAddressFamily .

Pour fermer un AF pour une liaison, le gestionnaire d’appels autonome doit appeler NdisCmNotifyCloseAddressFamily à partir du Fonction ProtocolUnbindAdapterEx . NDIS appelle ensuite le Fonction ProtocolClNotifyCloseAf du client qui a l’af af spécifié ouvert.

Si NdisCmNotifyCloseAddressFamily retourne NDIS_STATUS_PENDING, NDIS appelle le gestionnaire d’appels Fonction ProtocolCmNotifyCloseAfComplete une fois que le client a terminé l’opération de fermeture AF.

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_CallManager_Function(ndis)

Voir aussi

NdisMCmNotifyCloseAddressFamily

NdisRegisterProtocolDriver

ProtocolClNotifyCloseAf

ProtocolCmNotifyCloseAfComplete

ProtocolCmOpenAf

ProtocolUnbindAdapterEx