PMRX_CHANGE_BUFFERING_STATE_CALLDOWN - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// mrx.h
PMRX_CHANGE_BUFFERING_STATE_CALLDOWN PmrxChangeBufferingStateCalldown;
NTSTATUS PmrxChangeBufferingStateCalldown(
[in, out] IN OUT PRX_CONTEXT RxContext,
[in, out] IN OUT PMRX_SRV_OPEN SrvOpen,
[in] IN PVOID MRxContext
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
TheMRxCompleteBufferingStateChangeRequest routine is called by RDBSS to notify the network mini-redirector that a buffering state change request has been completed.
RxContext [in, out]A pointer to the RX_CONTEXT structure. This parameter contains the IRP that is requesting the operation.
SrvOpen [in, out]A pointer to a context parameter for use by the network mini-redirector callback routine.
MRxContext [in]A pointer to the SRV_OPEN structure and the associated FCB structure to be changed.
MRxCompleteBufferingStateChangeRequest returns STATUS_SUCCESS on success or an appropriate NTSTATUS value, such as the following:
| Return code | Description |
|---|---|
| STATUS_NOT_SUPPORTED | An option in the buffering request change is not supported. |
Before calling MRxCompleteBufferingStateChangeRequest, RDBSS:
Acquires an exclusive lock on the FCB structure.
Sets the FcbState member of SrvOpen->Fcb to FCB_STATE_BUFFERSTATE_CHANGING.
Modifies the following members in the RX_CONTEXT structure pointed to by the RxContext parameter:
If lock buffering is enabled, MRxCompleteBufferingStateChangeRequest will need to flush out the byte-range locks to the server. The list of locked regions is passed to the network mini-redirector in the LowIoContext.ParamsFor.Locks.LockList member of the RX_CONTEXT structure.
The Server Message Block (SMB) redirector uses MRxCompleteBufferingStateChangeRequest to send an oplock break response or to close the handle on an oplock break if the file is no longer in use. Byte range locks that need to be flushed out to the server are passed to the network mini-redirector in the LowIoContext.ParamsFor.Locks.LockList member of the RX_CONTEXT structure. The new oplock level is passed in the MrxContext parameter.
RDBSS ignores the return value from MRxCompleteBufferingStateChangeRequest.