MRxLowIOSubmit[LOWIO_OP_IOCTL] 例程

發行項
02/02/2024

RDBSS 會呼叫 MRxLowIOSubmit[LOWIO_OP_IOCTL] 例程，對網路迷你重新導向器發出 I/O 系統控制要求。

語法

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_IOCTL];

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

參數

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

傳回值

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

傳回碼	Description
STATUS_INSUFFICIENT_RESOURCES	資源不足，無法完成要求。
STATUS_INVALID_DEVICE_REQUEST	指定了無效的裝置要求。
STATUS_INVALID_PARAMETER	在 RxContext 中指定了無效的參數。
STATUS_NOT_IMPLEMENTED	未實作此例程。
STATUS_NOT_SUPPORTED	網路迷你重新導向器不支援指定的 IOCTL。

備註

RDBSS 會呼叫 MRxLowIOSubmit[LOWIO_OP_IOCTL] 以回應接收 IRP_MJ_DEVICE_CONTROL 或 IRP_MJ_INTERNAL_DEVICE_CONTROL 要求。

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

LowIoContext.Operation 成員會設定為 LOWIO_OP_IOCTL。

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

LowIoContext.ParamsFor.IoCtl.IoControlCode 成員會設定為 IOCTL 控件程式代碼。

LowIoContext.ParamsFor.IoCtl.pInputBuffer 成員會設定為輸入緩衝區。

LowIoContext.ParamsFor.IoCtl.InputBufferLength 成員會設定為輸入緩衝區長度。

LowIoContext.ParamsFor.IoCtl.pOutputBuffer 成員會設定為輸出緩衝區。

LowIoContext.ParamsFor.IoCtl.OutputBufferLength 成員會設定為輸出緩衝區長度。

當 MRxLowIOSubmit[LOWIO_OP_IOCTL] 例程正在處理時，RX_CONTEXT 的 LowIoContext.ResourceThreadId 成員保證會指出在 RDBSS 中起始作業的進程線程。 RX_CONTEXT的 LowIoContext.ResourceThreadId 成員可用來代表另一個線程釋放輸入資源。異步例程完成時，可以釋放從初始線程取得的輸入資源。