Funzione RxpUnregisterMinirdr (mrx.h)

Articolo
08/07/2023

RxpUnregisterMinirdr viene chiamato da un driver di mini-reindirizzamento di rete per annullare la registrazione del driver con RDBSS e rimuovere le informazioni di registrazione dalla tabella di registrazione di RDBSS interna.

Sintassi

void RxpUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parametri

[in] RxDeviceObject

Puntatore all'oggetto dispositivo RDBSS per questo redirector di rete.

Valore restituito

nessuno

Osservazioni

La routine RxpUnregisterMinirdr annulla la registrazione del driver con RDBSS e rimuove le informazioni di registrazione dalla tabella di registrazione RDBSS interna. Se le tabelle dei nomi sono state inizializzate, queste tabelle verranno finalizzate per il rilascio. Tutte le richieste asincrone in sospeso al mini-reindirizzamento di rete vengono attivate e tutti i thread di lavoro associati al redirector vengono indirizzato. RxpUnregisterMinirdr tenta anche di rimuovere l'oggetto dispositivo dal sistema chiamando IoDeleteDevice.

La routine RxpUnregisterMinirdr viene in genere chiamata come risultato di una richiesta MDFTL o IOCTL da un'applicazione o un servizio in modalità utente per scaricare il mini-redirector di rete, anche se questa chiamata può essere effettuata anche dal mini-redirector di rete o come parte dell'elaborazione dell'arresto da parte del sistema operativo o in seguito a un errore nella routine DriverEntry .

Si noti che la routine inline RxUnregisterMinirdr è il modo preferito per annullare la registrazione di un driver con RDBSS. La routine inline RxUnregisterMinirdr chiama RxpUnregisterMinirdr, ma decrementa anche il riferimento all'oggetto all'oggetto dispositivo RDBSS in modo che questo oggetto possa essere rilasciato dal sistema.