RxFinalizeNetFobx function (fcb.h)

Article
03/15/2022

RxFinalizeNetFOBX finalizes the given FOBX structure. The caller must have an exclusive lock on the FCB associated with FOBX structure.

Syntax

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Parameters

[out] ThisFobx

A pointer to the FOBX structure to finalize.

[in] RecursiveFinalize

The value indicating whether the finalization should be done recursively. This parameter is not currently used.

[in] ForceFinalize

The value indicating whether the finalization should be forced, regardless of the reference count.

If ForceFinalize is FALSE, then the NodeReferenceCount member of the FOBX structure pointed to by ThisFobx must be 0 for the FOBX to be finalized.

Return value

RxFinalizeNetFOBX returns TRUE on success or FALSE if the finalization did not occur:

Remarks

The RxFinalizeNetFOBX routine is not normally called by network mini-redirector drivers directly. RDBSS calls this routine internally when an I/O request packet is received for IRP_MJ_CLOSE. This IRP is normally received by RDBSS in response to a user-mode application requesting a file close operation. It is also possible for another kernel driver to issue such an IRP.

Before calling RxFinalizeNetFOBX, a lock on the FCB structure must be acquired in exclusive mode.

The RxFinalizeNetFOBX routine will call the MRxDeallocateForFobx routine provided by the network mini-redirector to free the memory for the FOBX if the network mini-redirector supports this routine.

Requirements

Requirement	Value
Target Platform	Desktop
Header	fcb.h (include Mrxfcb.h, Fcb.h)
IRQL	<= APC_LEVEL