MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] 例程

项目
06/15/2023

RDBSS 调用 MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] 例程，以请求网络微型重定向程序在文件对象上打开独占锁。

语法

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK];

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

参数

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

返回值

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

返回代码	说明
STATUS_CONNECTION_DISCONNECTED	连接已断开连接。
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法完成请求。
STATUS_INVALID_NETWORK_RESPONSE	从远程服务器收到无效响应。
STATUS_INVALID_PARAMETER	在 RxContext 中指定了无效的参数。
STATUS_LINK_FAILED	尝试重新连接到远程服务器以完成请求失败。
STATUS_NOT_IMPLEMENTED	此例程未实现。
STATUS_SHARING_VIOLATION	发生共享冲突。
STATUS_UNSUCCESSFUL	调用失败。

注解

如果 IrpSp-Flags> 设置了SL_EXCLUSIVE_LOCK位，RDBSS 调用 MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK]，以响应接收具有IRP_MN_LOCK次要代码的IRP_MJ_LOCK_CONTROL请求。

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

LowIoContext.Operation 成员设置为 LOWIO_OP_EXCLUSIVELOCK。

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

LowIoContext.ParamsFor.Locks.ByteOffset 成员设置为 IrpSp-Parameters.LockControl.ByteOffset.QuadPart> 的值。

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

LowIoContext.ParamsFor.Locks.Flags 成员设置为 IrpSp-Flags> 的值。

LowIoContext.ParamsFor.Locks.Length 成员设置为 IrpSp-Parameters.LockControl.Length.QuadPart> 的值。

RX_CONTEXT 结构的 LowIoContext.Operation 成员指定要执行的低 I/O 操作。多个低 I/O 例程可能指向网络微型重定向器中的同一例程，因为此 LowIoContext.Operation 成员可用于区分请求的低 I/O 操作。例如，与文件锁相关的所有 I/O 调用都可以在网络微型重定向器中调用相同的低 I/O 例程，并且该例程可以使用 LowIoContext.Operation 成员来区分所请求的锁定和解锁操作。

如果 MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] 例程可能需要很长时间才能完成，则网络微型重定向程序驱动程序应在启动网络通信之前释放 FCB 结构。可以通过调用 RxReleaseFcbResourceForThreadInMRx 来释放 FCB 结构。在处理 MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] 例程时，RX_CONTEXT的 LowIoContext.ResourceThreadId 成员保证指示在 RDBSS 中启动操作的进程线程。

可以使用 RX_CONTEXT 的 LowIoContext.ResourceThreadId 成员代表另一个线程释放 FCB 结构。异步例程完成后，可以释放从初始线程获取的 FCB 结构。