Partager via


NdisUnbindAdapter, fonction (ndis.h)

Les pilotes de protocole appellent la fonction NdisUnbindAdapter pour demander à NDIS de fermer une liaison à un adaptateur miniport sous-jacent.

Syntaxe

NDIS_STATUS NdisUnbindAdapter(
  [in] NDIS_HANDLE NdisBindingHandle
);

Paramètres

[in] NdisBindingHandle

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

Valeur de retour

NdisUnbindAdapter retourne l’une des valeurs d’état suivantes :

Retourner le code Description
NDIS_STATUS_SUCCESS
NdisUnbindAdapter lancé avec succès 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 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 transmis au paramètre NdisBindingHandle est toujours valide.

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

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible Bureau
d’en-tête ndis.h (include Ndis.h)
bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
règles de conformité DDI Irql_Protocol_Driver_Function(ndis)

Voir aussi

NdisOpenAdapterEx

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx