RxFinalizeNetFobx function (fcb.h)
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 |