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.
NDIS_STATUS NdisCloseAdapterEx(
[in] NDIS_HANDLE NdisBindingHandle
);
[in] NdisBindingHandle
Handle fourni par NDIS au paramètre NdisBindingHandle de NdisOpenAdapterEx. Ce handle identifie la liaison que NDIS doit fermer.
NdisCloseAdapterEx retourne l’une des valeurs d’état suivantes :
Retourner le code | Description |
---|---|
|
NdisCloseAdapterEx correctement fermé la liaison à l’adaptateur miniport sous-jacent. |
|
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. |
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.
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) |