MRxLowIOSubmit[LOWIO_OP_READ] 例程

项目
02/02/2024

RDBSS 调用 MRxLowIOSubmit[LOWIO_OP_READ] 例程，向网络微型重定向程序发出读取请求。

语法

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_READ];

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

参数

RxContext [in， out]
指向RX_CONTEXT结构的指针。此参数包含请求操作的 IRP。

返回值

MRxLowIOSubmit[LOWIO_OP_READ] 在成功时返回STATUS_SUCCESS或相应的 NTSTATUS 值，例如以下值之一：

返回代码	说明
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_READ] 以响应接收 IRP_MJ_READ 请求。

在调用 MRxLowIOSubmit[LOWIO_OP_READ]之前，RDBSS 修改 RxContext 参数指向的 RX_CONTEXT 结构中的以下成员：

LowIoContext.Operation 成员设置为 LOWIO_OP_READ。

LowIoContext.ResourceThreadId 成员设置为在 RDBSS 中启动操作的进程线程。

LowIoContext.ParamsFor.ReadWrite.Key 成员设置为 IrpSp-Parameters.Read.Key> 的值。

如果 Irp-Flags> 已打开 IRP_PAGING_IO 位，则 ParamsFor.ReadWrite.Flags 成员已将 LOWIO_READWRITEFLAG_PAGING_IO 位设置为 on。

ParamsFor.ReadWrite.Buffer 成员设置为 IoReadAccess 锁定的用户缓冲区。

LowIoContext.ParamsFor.ReadWrite.ByteCount 成员设置为 IrpSp-Parameters.Read.Length> 的值。

读取请求通常由网络微型重定向程序作为异步操作实现，因为它可能需要相当长的时间。该操作通常包括向远程服务器发送网络请求。当在服务器上完成读取请求时，将获取响应。这是一个操作示例，网络微型重定向程序可能需要为其注册上下文来处理本地启动的取消。

在处理 MRxLowIOSubmit[LOWIO_OP_READ] 例程时，RX_CONTEXT 的 LowIoContext.ResourceThreadId 成员保证指示在 RDBSS 中启动操作的进程线程。 LowIoContext.ResourceThreadId 成员可用于代表另一个线程释放 FCB 结构。异步例程完成后，可以释放从初始线程获取的 FCB 结构。可以通过调用 RxReleaseFcbResourceForThreadInMRx 来释放 FCB 结构。