RxpUnregisterMinirdr, fonction (mrx.h)

Article
02/26/2024

RxpUnregisterMinirdr est appelé par un pilote de mini-redirecteur réseau pour désinscrire le pilote auprès de RDBSS et supprimer les informations d’inscription de la table d’inscription RDBSS interne.

Syntaxe

void RxpUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Paramètres

[in] RxDeviceObject

Pointeur vers l’objet d’appareil RDBSS pour ce redirecteur réseau.

Valeur de retour

None

Remarques

La routine RxpUnregisterMinirdr annule l’inscription du pilote auprès de RDBSS et supprime les informations d’inscription de la table d’inscription RDBSS interne. Si les tables de noms ont été initialisées, ces tables seront finalisées pour la mise en production. Toutes les demandes asynchrones en suspens adressées au mini-redirecteur réseau sont mises hors service, et tous les threads de travail associés au redirecteur sont épinglurés. RxpUnregisterMinirdr tente également de supprimer l’objet d’appareil du système en appelant IoDeleteDevice.

La routine RxpUnregisterMinirdr est généralement appelée à la suite d’une demande FSCTL ou IOCTL d’une application ou d’un service en mode utilisateur pour décharger le mini-redirecteur réseau, bien que cet appel puisse également être effectué à partir du mini-redirecteur réseau ou dans le cadre d’un traitement d’arrêt par le système d’exploitation ou à la suite d’une défaillance dans la routine DriverEntry .

Notez que la routine inline, RxUnregisterMinirdr, est le moyen préféré pour annuler l’inscription d’un pilote avec RDBSS. La routine inline RxUnregisterMinirdr appelle RxpUnregisterMinirdr, mais décrémente également la référence d’objet à l’objet d’appareil RDBSS afin que cet objet puisse être libéré par le système.