NdisCloseAdapter, fonction (ndis.h)
Remarque NDIS 5. x a été déconseillé et est remplacé par NDIS 6. x. Pour le développement de nouveaux pilotes NDIS, consultez Pilotes réseau à partir de Windows Vista. Pour plus d’informations sur le portage de NDIS 5. pilotes x vers NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.
NdisCloseAdapter libère la liaison établie et les ressources allouées lorsque le protocole appelé NdisOpenAdapter.
Syntaxe
void NdisCloseAdapter(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE NdisBindingHandle
);
Paramètres
[out] Status
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne l’état de l’opération de fermeture, qui peut être l’une des valeurs suivantes :
NDIS_STATUS_SUCCESS
La liaison a été fermée et toutes les ressources relatives à cette liaison ont été libérées.NDIS_STATUS_PENDING
Une demande d’adaptateur de fermeture est gérée de manière asynchrone et la fonction ProtocolCloseAdapterComplete de l’appelant est appelée lorsque l’opération de fermeture est terminée.
[in] NdisBindingHandle
Spécifie le handle retourné par NdisOpenAdapter qui identifie la carte virtuelle ou la carte réseau à fermer.
Valeur de retour
Aucun
Remarques
Valeur de retour : None
Un pilote de protocole appelle généralement NdisCloseAdapter à partir de sa fonction ProtocolUnbindAdapter. Il peut également appeler NdisCloseAdapter à partir de sa fonction ProtocolBindAdapter, par exemple, si elle n’a pas pu définir une valeur OID après avoir appelé NdisOpenAdapter pour configurer une liaison.
Dès qu’un protocole appelle NdisCloseAdapter, le handle à NdisBindingHandle doit être considéré comme non valide par l’appelant. Il s’agit d’une erreur de programmation pour transmettre ce handle dans tout appel ultérieur à une fonction NdisXxx.
- Plateforme cible : universelle
- Version : non pris en charge pour les pilotes NDIS 6.0 dans Windows Vista. Utilisez NdisCloseAdapterEx à la place. Pris en charge pour les pilotes NDIS 5.1 dans Windows Vista et Windows XP.
Exigences
Exigence | Valeur |
---|---|
d’en-tête | ndis.h (include Ndis.h) |
bibliothèque | Ndis.lib |
IRQL | PASSIVE_LEVEL |