NdisCloseAdapter, fonction (ndis.h)

  • Article

Note NDIS 5. x a été déprécié 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. x pilotes 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 le status 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

None

Remarques

Valeur de retour : aucune

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, s’il 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 de NdisBindingHandle doit être considéré comme non valide par l’appelant. Il s’agit d’une erreur de programmation pour passer 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.

Configuration requise

Condition requise Valeur
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL PASSIVE_LEVEL

Voir aussi