RxpUnregisterMinirdr function

RxpUnregisterMinirdr is called by a network mini-redirector driver to de-register the driver with RDBSS and remove the registration information from the internal RDBSS registration table.

Syntax

void RxpUnregisterMinirdr(
  IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parameters

RxDeviceObject

A pointer to the RDBSS device object for this network redirector.

Return Value

None

Remarks

The RxpUnregisterMinirdr routine unregisters the driver with RDBSS and removes the registration information from the internal RDBSS registration table. If name tables were initialized, then these tables will be finalized for release. Any outstanding asynchronous requests to the network mini-redirector are spun down, and any worker threads associated with the redirector are spun down. RxpUnregisterMinirdr also tries to remove the device object from the system by calling IoDeleteDevice.

The RxpUnregisterMinirdr routine is usually called as a result of an FSCTL or IOCTL request from a user-mode application or service to unload the network mini-redirector, although this call could also be made from the network mini-redirector or as part of shutdown processing by the operating system or as a result of a failure in the DriverEntry routine.

Note that the inline routine, RxUnregisterMinirdr, is the preferred way to unregister a driver with RDBSS. The RxUnregisterMinirdr inline routine calls RxpUnregisterMinirdr, but then also decrements the object reference to the RDBSS device object so that this object can be released by the system.

Requirements

   
Target Platform Desktop
Header mrx.h (include Mrx.h)
IRQL "<= APC_LEVEL"

See Also

DriverEntry

IoDeleteDevice

RxRegisterMinirdr

RxStartMiniRdr

RxStopMiniRdr

RxUnregisterMinirdr