MRxLowIOSubmit[LOWIO_OP_UNLOCK] 例程

RDBSS 调用 MRxLowIOSubmit[LOWIO_OP_UNLOCK] 例程,请求网络微型重定向程序删除文件对象上的单个锁。

语法

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_UNLOCK];

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

参数

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

返回值

MRxLowIOSubmit[LOWIO_OP_UNLOCK] 在成功时返回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

调用失败。

注解

RDBSS 调用 MRxLowIOSubmit[LOWIO_OP_UNLOCK] 以响应接收 IRP_MJ_LOCK_CONTROL 请求,该请求的次要代码为 IRP_MN_UNLOCK_SINGLE。

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

LowIoContext.Operation 成员设置为 LOWIO_OP_UNLOCK。

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

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

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

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

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

要求

目标平台

桌面

标头

Mrx.h (包括 Mrx.h)

另请参阅

MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK]

MRxLowIOSubmit[LOWIO_OP_FSCTL]

MRxLowIOSubmit[LOWIO_OP_IOCTL]

MRxLowIOSubmit[LOWIO_OP_NOTIFY_CHANGE_DIRECTORY]

MRxLowIOSubmit[LOWIO_OP_READ]

MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK]

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE]

MRxLowIOSubmit[LOWIO_OP_WRITE]

RxReleaseFcbResourceForThreadInMRx