NdisDeregisterProtocol, 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.

NdisDeregisterProtocol libère les ressources allouées lorsque le pilote a appelé NdisRegisterProtocol.

Syntaxe

void NdisDeregisterProtocol(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisProtocolHandle
);

Paramètres

[out] Status

Pointeur vers une variable fournie par l’appelant qui est définie sur NDIS_STATUS_SUCCESS au retour de cette fonction.

[in] NdisProtocolHandle

Spécifie le handle retourné par NdisRegisterProtocol lors de l’initialisation du pilote.

Valeur de retour

None

Remarques

Les pilotes de protocole inscrits appellent NdisDeregisterProtocol dans l’une des circonstances suivantes :

  • Le pilote a déjà appelé NdisRegisterProtocol avec succès, mais il ne peut pas être lié à un pilote NDIS sous-jacent sur l’ordinateur.

  • Le pilote est en cours de déchargement. Autrement dit, la routine Unload configurée dans son objet pilote pendant l’initialisation a été appelée ou la fonction ProtocolUnbindAdapter a été appelée pour libérer la dernière liaison restante du pilote.

    Pour plus d’informations sur la routine de déchargement et d’autres routines de pilotes standard en mode noyau, consultez Composants du pilote en mode noyau.

  • Le système est en cours d’arrêt. Étant donné que le pilote, qui est un protocole de niveau supérieur, appelé IoRegisterShutdownNotification lors de son initialisation , sa routine d’arrêt a été appelée.

    Pour plus d’informations, consultez IoRegisterShutdownNotification .

Si un protocole a des liaisons ouvertes, son appel à NdisDeregisterProtocol amène NDIS à appeler la fonction ProtocolUnbindAdapter du protocole une fois pour chaque liaison ouverte. ProtocolUnbindAdapter appelle NdisCloseAdapter pour fermer la liaison.

Lorsque les ouvertures en attente, le cas échéant, ont été fermées, NdisDeregisterProtocol libère tous les filtres que son appelant a configurés et libère la mémoire NDIS allouée pour suivre les liaisons et les filtres pour le pilote de protocole.

  • Plateforme cible : Universelle
  • Version : non pris en charge pour les pilotes NDIS 6.0 dans Windows Vista. Utilisez NdisDeregisterProtocolDriverà 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