次の方法で共有

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] ルーチン

  • [アーティクル]

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] ルーチンは、ネットワーク ミニ リダイレクターがファイル オブジェクトに保持されている複数のロックを削除するように要求するために RDBSS によって呼び出されます。

構文

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE];

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

パラメーター

RxContext [in, out]
RX_CONTEXT 構造体へのポインター。 このパラメーターには、操作を要求している IRP が含まれています。

戻り値

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] は、成功した場合の 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 は、IRP_MN_UNLOCK_ALL または IRP_MN_UNLOCK_ALL_BY_KEY のマイナー コードで IRP_MJ_LOCK_CONTROL 要求を受信した場合に応答して MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] を呼び出します。

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] を呼び出す前に、RDBSS は RxContext パラメーターが指す RX_CONTEXT 構造体の次のメンバーを変更します。

LowIoContext.Operation メンバーが LOWIO_OP_UNLOCK_MULTIPLE に設定されています。

LowIoContext.ResourceThreadId メンバーは、RDBSS で操作を開始したプロセスのスレッドに設定されます。

LowIoContext.ParamsFor.Locks.LockList メンバーは、LOWIO_LOCK_LIST 要素の一覧に設定されます。 各要素は、ロックを解除する範囲を指定します。

ロック解除するバイト範囲は、RX_CONTEXT 構造体の LowIoContext.ParamsFor.Locks.LockList メンバーで指定されます。 LOWIO_LOCK_LIST 構造体は次のように定義されます。

typedef struct _LOWIO_LOCK_LIST {
  struct  _LOWIO_LOCK_LIST  *Next;
  ULONG  LockNumber;
  RXVBO  ByteOffset;
  LONGLONG  Length;
  ULONG  Key;
  BOOLEAN  ExclusiveLock;
} LOWIO_LOCK_LIST, *PLOWIO_LOCK_LIST;

RX_CONTEXTの LowIoContext.Operation メンバーは、実行する低速 I/O 操作を指定します。 この LowIoContext.Operation メンバーは、要求された低速 I/O 操作を区別するために使用できるため、複数の低速 I/O ルーチンがネットワーク ミニリダイレクターの同じルーチンを指すことができます。 たとえば、ファイル ロックに関連するすべての I/O 呼び出しは、ネットワーク ミニ リダイレクターで同じ低速 I/O ルーチンを呼び出すことができ、このルーチンは LowIoContext.Operation メンバーを使用して、要求されたロック操作とロック解除操作を区別できます。

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] ルーチンの完了に時間がかかる場合、ネットワーク ミニ リダイレクター ドライバーは、ネットワーク通信を開始する前に FCB 構造体を解放する必要があります。 FCB 構造体を解放するには、RxReleaseFcbResourceForThreadInMRx を呼び出します。 MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE] ルーチンが処理されている間、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]

MRxLowIOSubmit[LOWIO_OP_WRITE]

RxReleaseFcbResourceForThreadInMRx