Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
RxFinishFcbInitialization is used to finish initializing an FCB after the successful completion of a create operation by the network mini-redirector.
Syntax
void RxFinishFcbInitialization(
IN OUT PMRX_FCB Fcb,
IN RX_FILE_TYPE FileType,
IN PFCB_INIT_PACKET InitPacket
);
Parameters
Fcb
A pointer to the MRX_FCB structure being initialized.
FileType
The value indicating the storage type of entity that the FCB refers to. Possible options for this parameter include the following:
| Value | Meaning |
|---|---|
| RDBSS_NTC_MAILSLOT | A mail slot. |
| RDBSS_NTC_SPOOLFILE | A printer spool file. |
| RDBSS_NTC_STORAGE_TYPE_DIRECTORY | A directory. |
| RDBSS_NTC_STORAGE_TYPE_UNKNOWN | The storage type is unknown. |
| RDBSS_NTC_STORAGE_TYPE_FILE | A file. |
InitPacket
Pointer to extra data that is required for initialization depending on the storage type of the FCB being initialized. This parameter may be a NULL pointer if no extra data is provided.
Return value
None
Remarks
When called as a result of an IRP_MJ_CREATE, RxCreateNetFCB is called first to create the FCB. If the Type member of the NET_ROOT to be created is not a NET_ROOT_MAILSLOT, then RxFinishFcbInitialization is called to finish the initialization of the FCB structure.
If the FcbState member of the MRX_FCB structure pointed to by MrxFcb does not have the FCB_STATE_TIME_AND_SIZE_ALREADY_SET on, then the following members of the FCB will be updated from the InitPacket parameter if InitPacket is non NULL: Attributes, NumberOfLinks, CreationTime, LastAccessTime, LastWriteTime, LastChangeTime, ActualAllocationLength, Header.AllocationSize, Header.FileSize, and Header.ValidDataLength. The FCB_STATE_TIME_AND_SIZE_ALREADY_SET option is then set on in the FcbState member of the FCB structure.
If the storage type is an RDBSS_NTC_MAILSLOT and the FcbState member of the FCB does have the FCB_STATE_TIME_AND_SIZE_ALREADY_SET option set on, then the following members of the FCB structure for the mail slot will be initialized to 0: Attributes, NumberOfLinks, CreationTime.QuadPart, LastAccessTime.QuadPart, LastWriteTime.QuadPart, LastChangeTime.QuadPart, ActualAllocationLength, Header.AllocationSize.QuadPart, Header.FileSize.QuadPart, and Header.ValidDataLength.QuadPart
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | fcb.h (include Mrxfcb.h, Nodetype.h, Fcb.h) |
| IRQL | <= APC_LEVEL |