// fcb.h
PMRX_FOBX RxCreateNetFobx(
[out] OUT PRX_CONTEXT RxContext,
[in] IN PMRX_SRV_OPEN MrxSrvOpen
);
View the official Windows Driver Kit DDI referenceNo description available.
RxCreateNetFobx allocates, initializes, and inserts a new file object extension (FOBX) structure into the in-memory data structures for a FCB that this FOBX is being opened on.
RxContext [out]A pointer to the RX_CONTEXT structure describing a create operation.
MrxSrvOpen [in]A pointer to the associated SRV_OPEN structure.
RxCreateNetFobx returns a pointer to a newly allocated FOBX data structure on success or a NULL pointer on failure.
Network mini-redirectors should call RxCreateNetFobx to create an FOBX at the end of a successful create operation.
Before calling RxCreateNetFobx, the FCB associated with the FOBX structure must be acquired in exclusive mode.
RxCreateNetFobx will try and use the FOBX allocated as part of the associated FCB structure if it is available. If the FOBX allocated with the FCB is not available, then RxCreateNetFobx will try and use the FOBX allocated as part of the associated SRV_OPEN structure if it is available. In either of these cases, RxCreateNetFobx only needs to initialize the existing FOBX structure, no memory allocation is required. If both of the FOBX structures on the associated FCB and SRV_OPEN structure are not available, then RxCreateNetFobx will allocate a new FOBX structure.
If the associated FCB is a paging file, RxCreateNetFobx allocates non-paged pool memory when creating the new FOBX data structure. If the associated FCB is a not a paging file, RxCreateNetFobx allocates paged pool memory when creating the new FOBX data structure.
Windows does not currently allow having a paging file on a remote machine.
On success, the following FOBX members in the FOBX structure are set:
On success, the reference count for the SRV_OPEN structure is incremented and the NumberOfFobxs member on the associated V_NET_ROOT structure is incremented.