Partager via


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

Voir aussi