MRxLowIOSubmit[LOWIO_OP_IOCTL] 例程

项目
06/15/2023

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] 在成功时返回STATUS_SUCCESS或相应的 NTSTATUS 值，例如以下值之一：

返回代码	说明
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 成员可用于代表另一个线程释放输入资源。异步例程完成后，可以释放从初始线程获取的输入资源。