RxUnregisterMinirdr routine

RxUnregisterMinirdr is an inline routine 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 RxUnregisterMinirdr(
  _In_ PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parameters

RxDeviceObject [in]

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

Return value

None

Remarks

RxUnregisterMinirdr is an inline routine defined in rxstruc.h that de-registers 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. RxUnregisterMinirdr also tries to remove the device object from the system by calling IoDeleteDevice.

Typically, the RxUnregisterMinirdr routine is 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

Rxstruc.h (include Rxstruc.h or Mrx.h)

IRQL

<= APC_LEVEL

See also

DriverEntry
IoDeleteDevice
RxRegisterMinirdr
RxStartMiniRdr
RxStopMiniRdr
RxpUnregisterMinirdr

 

 

Send comments about this topic to Microsoft

Show: