Edit

RxPurgeAllFobxs function (rxprocs.h)

  • Article

RxPurgeAllFobxs purges all of the FOBX structures associated with a network mini-redirector.

Syntax

void RxPurgeAllFobxs(
  PRDBSS_DEVICE_OBJECT RxDeviceObject
);

Parameters

RxDeviceObject

A pointer to the mini-redirector device object for which the purge should be done.

Return value

None

Remarks

At cleanup, there are no more user handles associated with the file object. In such cases, the time window between close and cleanup is dictated by the additional references maintained by memory manager and cache manager. RDBSS uses a scavenger process running on a separate thread to scavenge and purge unneeded FOBX and other structures.

A network mini-redirector might call RxPurgeAllFobxs and RxScavengeAllFobsx in response to a PnP power change event.

The RxPurgeAllFobxs routine acquires the scavenger mutex, traverses the ClosePendingFobxsList member on the scavenger object removing list entries, and then releases the mutex. If the FOBX structure is not NULL, RxPurgeAllFobxs will purge the FOBX structure and try to acquire an exclusive lock on the associated FCB structure. If successful, RxPurgeAllFobxs will then try to dereference the NET_FOBX structure and dereference, finalize, and release the FCB structure.

On checked builds, RxPurgeAllFobxs causes the system to ASSERT for a number of conditions including the following:

  • The Flink member of RxScavenger->ClosePendingFobxsList structure on the RxDeviceObject is NULL.
  • Fobx->NodeTypeCode is not RDBSS_NTC_FOBX.
  • The Flink and Blink members for a list entry are NULL.

Requirements

Requirement Value
Target Platform Desktop
Header rxprocs.h (include Rxprocs.h)
IRQL <= APC_LEVEL

See also

RxPurgeRelatedFobxs

RxScavengeAllFobxs

RxScavengeFobxsForNetRoot