Fonction NdisMRegisterUnloadHandler (ndis.h)

  • Article

Note 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. x pilotes dans NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

La fonction NdisMRegisterUnloadHandler inscrit un gestionnaire de déchargement pour un pilote.

Syntaxe

void NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

Paramètres

[in] NdisWrapperHandle

Spécifie le handle retourné par NdisMInitializeWrapper.

[in] UnloadHandler

Spécifie le point d’entrée pour la routine de déchargement du pilote. Une routine de déchargement est déclarée comme suit :

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

Valeur de retour

None

Remarques

Un pilote appelle NdisMRegisterUnloadHandler à partir de sa fonction DriverEntry après que DriverEntry a appelé NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport. NdisMRegisterUnloadHandler inscrit un gestionnaire de déchargement pour le pilote.

Les fonctionnalités du gestionnaire de déchargement sont spécifiques au pilote. Par exemple, un pilote intermédiaire doit inscrire un gestionnaire de déchargement qui appelle NdisDeregisterProtocol pour annuler l’inscription de la partie protocole du pilote intermédiaire. Le gestionnaire de déchargement doit également effectuer toutes les opérations de nettoyage nécessaires, telles que la désaffectation des ressources utilisées par la partie protocole du pilote.

Un pilote miniport, tel qu’un pilote miniport d’équilibrage de charge, qui surveille plusieurs pilotes miniports instance doit inscrire un gestionnaire de déchargement qui nettoie les informations d’état et libère les ressources après l’arrêt des instances de pilotes miniport qu’il surveille. Notez qu’un gestionnaire de déchargement diffère d’une fonction MiniportHalt : le gestionnaire de déchargement a une étendue plus globale, tandis que l’étendue de la fonction MiniportHalt est limitée à un pilote miniport particulier instance.

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