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 retournée
NdisCloseAdapterEx retourne l’une des valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
NdisCloseAdapterEx a correctement fermé la liaison à l’adaptateur miniport sous-jacent. |
|
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) |