NdisMDeregisterDevice, fonction (ndis.h)

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 NdisMDeregisterDevice supprime du système un objet d’appareil créé avec NdisMRegisterDevice. NdisMDeregisterDevice supprime également le lien symbolique associé à cet objet d’appareil.

Syntaxe

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

Paramètres

[in] NdisDeviceHandle

Spécifie le handle retourné par NdisMRegisterDevice qui identifie l’objet d’appareil à désinscrire.

Valeur retournée

NdisMDeregisterDevice retourne NDIS_STATUS_SUCCESS si l’objet d’appareil et son objet de lien symbolique associé sont supprimés.

Remarques

Un pilote appelle NdisMDeregisterDevice à partir de sa fonction Halt ou Unload pour désinscrire un objet d’appareil autonome qu’il a créé précédemment avec NdisMRegisterDevice. Le pilote doit appeler NdisMDeregisterDevice lorsqu’il est déchargé ou lorsque sa routine DriverEntry rencontre une erreur d’initialisation irrécupérable, telle qu’une incapacité à obtenir des ressources système.

Lorsque NdisMRegisterDevice est appelé, il ne peut pas y avoir d’opérations d’ouverture en mode utilisateur en cours de suppression sur l’objet d’appareil. S’il y en a, une erreur système se produit.

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