NdisCloseAdapterEx, fonction (ndis.h)

  • Article

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 retournée

NdisCloseAdapterEx retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS
 NdisCloseAdapterEx a 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 sera effectuée de manière asynchrone. NDIS appelle le pilote de protocole Fonction ProtocolCloseAdapterCompleteEx lorsque l’opération est 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 se terminent avant d’appeler NdisCloseAdapterEx.

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

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)

Voir aussi

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx