Lire en anglais

Partager via


NdisCloseAdapterEx, fonction (ndis.h)

Un pilote de protocole appelle la fonction NdisCloseAdapterEx pour libérer la liaison et les ressources qui ont été allouées lorsque le pilote a appelé la fonction NdisOpenAdapterEx.

Syntaxe

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

Paramètres

[in] NdisBindingHandle

Handle fourni par NDIS au paramètre NdisBindingHandle de NdisOpenAdapterEx. Ce handle identifie la liaison que NDIS doit fermer.

Valeur de retour

NdisCloseAdapterEx retourne l’une des valeurs d’état suivantes :

Retourner le code Description
NDIS_STATUS_SUCCESS
NdisCloseAdapterEx correctement fermé la liaison à l’adaptateur miniport sous-jacent.
NDIS_STATUS_PENDING
NdisCloseAdapterEx n’a pas terminé l’opération de fermeture et l’opération est terminée de façon asynchrone. NDIS appelle le pilote de protocole ProtocolCloseAdapterCompleteEx fonction une fois l’opération terminée.

Remarques

Un pilote de protocole appelle généralement NdisCloseAdapterEx à partir de son Fonction ProtocolUnbindAdapterEx. Le pilote peut également appeler NdisCloseAdapterEx à partir de sa fonction ProtocolBindAdapterEx. Par exemple, si le pilote n’a pas pu définir une valeur OID après avoir appelé NdisOpenAdapterEx, il peut appeler NdisCloseAdapterEx à partir de sa fonction ProtocolBindAdapterEx.

Si un pilote de protocole doit fermer un adaptateur miniport en dehors du contexte de ProtocolUnbindAdapterEx ou ProtocolBindAdapterEx, il doit appeler la fonction NdisUnbindAdapter.

Les pilotes de protocole doivent attendre que toutes les demandes d’envoi et les demandes OID qu’ils proviennent soient terminées avant d’appeler NdisCloseAdapterEx.

Dès que le pilote appelle NdisCloseAdapterEx, le handle obtenu à partir de la fonction NdisOpenAdapterEx au paramètre NdisBindingHandle devient non valide.

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)

Voir aussi

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx