NdisUnbindAdapter, fonction (ndis.h)

  • Article

Les pilotes de protocole appellent la fonction NdisUnbindAdapter pour demander à NDIS de fermer une liaison à une carte miniport sous-jacente.

Syntaxe

NDIS_STATUS NdisUnbindAdapter(
  [in] NDIS_HANDLE NdisBindingHandle
);

Paramètres

[in] NdisBindingHandle

Handle que le pilote de protocole a obtenu à partir d’un appel à la fonction NdisOpenAdapterEx . Le handle identifie la liaison à fermer.

Valeur retournée

NdisUnbindAdapter retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS
 NdisUnbindAdapter a correctement lancé l’opération unbind.
NDIS_STATUS_RESOURCES
 NdisUnbindAdapter a échoué en raison de ressources insuffisantes.

Remarques

Les pilotes de protocole appellent NdisUnbindAdapter en dehors du contexte des fonctions ProtocolUnbindAdapterEx ou ProtocolBindAdapterEx . NDIS planifie un élément de travail pour appeler la fonction ProtocolUnbindAdapterEx du pilote de protocole et retourne immédiatement.

Avant que l’appel à NdisUnbindAdapter ne retourne, NDIS peut déjà avoir fermé la liaison. Par conséquent, une fois l’appel retourné, l’appelant ne doit pas supposer que le handle qu’il a passé au paramètre NdisBindingHandle est toujours valide.

Note NDIS peut ne pas appeler ProtocolUnbindAdapterEx même si NdisUnbindAdapter retourne NDIS_STATUS_SUCCESS.
 

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 <= DISPATCH_LEVEL
Règles de conformité DDI Irql_Protocol_Driver_Function(ndis)

Voir aussi

NdisOpenAdapterEx

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx