MRxLowIOSubmit[LOWIO_OP_WRITE] 例程

發行項
02/07/2024

RDBSS 會呼叫 MRxLowIOSubmit[LOWIO_OP_WRITE] 例程，以對網路迷你重新導向器發出寫入要求。

語法

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_WRITE];

NTSTATUS MRxLowIOSubmit[LOWIO_OP_WRITE](
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

參數

RxContext [in， out]
RX_CONTEXT 結構的指標。此參數包含要求作業的 IRP。

傳回值

MRxLowIOSubmit[LOWIO_OP_WRITE] 會在成功或適當的 NTSTATUS 值時傳回STATUS_SUCCESS，例如下列其中一項：

傳回碼	Description
STATUS_FILE_CLOSED	已取得FCB結構，但已關閉相關聯的SRV_OPEN結構。
STATUS_INSUFFICIENT_RESOURCES	資源不足，無法完成要求。
STATUS_INVALID_DEVICE_REQUEST	指定了無效的裝置要求。
STATUS_INVALID_PARAMETER	在 RxContext 中指定了無效的參數。
STATUS_NOT_IMPLEMENTED	未實作此例程。
STATUS_NOT_SUPPORTED	網路迷你重新導向器不支援指定的要求。

備註

RDBSS 會呼叫 MRxLowIOSubmit[LOWIO_OP_WRITE] 以回應接收 IRP_MJ_WRITE 要求。

在呼叫 MRxLowIOSubmit[LOWIO_OP_WRITE]之前，RDBSS 會修改 RxContext 參數所指向RX_CONTEXT結構中的下列成員：

LowIoContext.Operation 成員會設定為 LOWIO_OP_WRITE。

LowIoContext.ResourceThreadId 成員會設定為在 RDBSS 中起始作業的進程線程。

LowIoContext.ParamsFor.ReadWrite.Key 成員會設定為 IrpSp-Parameters.Read.Key> 的值。

如果 Irp-Flags> 上的 IRP_PAGING_IO 位，則 ParamsFor.ReadWrite.Flags 成員的 LOWIO_READWRITEFLAG_PAGING_IO 位已設定為開啟。

ParamsFor.ReadWrite.Buffer 成員會設定為針對 IoWriteAccess 鎖定的用戶緩衝區。

LowIoContext.ParamsFor.ReadWrite.ByteCount 成員會設定為 IrpSp-Parameters.Write.Length> 的值。

寫入要求通常是由網路迷你重新導向器實作為異步操作，因為它可能需要相當長的時間。此作業通常包含將網路要求傳送至遠端伺服器。在伺服器上完成寫入要求時，會取得回應。這是網路迷你重新導向器可能需要註冊內容來處理本機起始取消的作業範例。

雖然 MRxLowIOSubmit[LOWIO_OP_WRITE] 例程正在處理，但RX_CONTEXT的 LowIoContext.ResourceThreadId 成員保證會指出在 RDBSS 中起始作業的進程線程。 LowIoContext.ResourceThreadId 成員可用來代表另一個線程釋放 FCB 結構。異步例程完成時，可以釋放從初始線程取得的FCB結構。您可以藉由呼叫 RxReleaseFcbResourceForThreadInMRx 來釋放 FCB 結構。