RxUnregisterMinirdr-Funktion (rxstruc.h)

Artikel
02/26/2024

RxUnregisterMinirdr ist eine Inlineroutine, die von einem Netzwerk-Miniumleitungstreiber aufgerufen wird, um die Registrierung des Treibers bei RDBSS aufzuheben und die Registrierungsinformationen aus der internen RDBSS-Registrierungstabelle zu entfernen.

Syntax

void RxUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parameter

[in] RxDeviceObject

Ein Zeiger auf das RDBSS-Geräteobjekt für diesen Netzwerkumleitungsor.

Rückgabewert

Keine

Bemerkungen

RxUnregisterMinirdr ist eine in rxstruc.h definierte Inlineroutine, die die Registrierung des Treibers bei RDBSS aufhebt und die Registrierungsinformationen aus der internen RDBSS-Registrierungstabelle entfernt. Wenn Namenstabellen initialisiert wurden, werden diese Tabellen für die Veröffentlichung finalisiert. Alle ausstehenden asynchronen Anforderungen an den Netzwerkminiumleitungsor werden heruntergefahren, und alle Workerthreads, die dem Umleitungsor zugeordnet sind, werden heruntergefahren. RxUnregisterMinirdr versucht auch, das Geräteobjekt aus dem System zu entfernen, indem IoDeleteDevice aufgerufen wird.

In der Regel wird die RxUnregisterMinirdr-Routine als Ergebnis einer FSCTL- oder IOCTL-Anforderung von einer Benutzermodusanwendung oder eines Diensts aufgerufen, um den Netzwerk-Mini-Redirector zu entladen, obwohl dieser Aufruf auch vom Netzwerk-Miniumleitungsor oder als Teil der Verarbeitung durch das Betriebssystem oder als Ergebnis eines Fehlers in der DriverEntry-Routine erfolgen kann.

Beachten Sie, dass die Inlineroutine RxUnregisterMinirdr die bevorzugte Methode ist, um die Registrierung eines Treibers bei RDBSS aufzuheben. Die RxUnregisterMinirdr-Inlineroutine ruft RxpUnregisterMinirdr auf, dekrementiert dann aber auch den Objektverweis auf das RDBSS-Geräteobjekt, sodass dieses Objekt vom System freigegeben werden kann.