次の方法で共有

MRxLowIOSubmit[LOWIO_OP_READ] ルーチン

  • [アーティクル]

MRxLowIOSubmit[LOWIO_OP_READ] ルーチンは、RDBSS によって呼び出され、ネットワーク ミニ リダイレクターに読み取り要求を発行します。

構文

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 は、IRP_MJ_READ 要求の受信に応答して MRxLowIOSubmit[LOWIO_OP_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 の値に設定されます。

ParamsFor.ReadWrite.Flags メンバーは、Irp->Flags が IRP_PAGING_IO ビットをオンにしている場合、LOWIO_READWRITEFLAG_PAGING_IO ビットが設定されます。

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 構造体を解放できます。 FCB 構造体を解放するには、RxReleaseFcbResourceForThreadInMRx を呼び出します。

要件

対象プラットフォーム

 デスクトップ

ヘッダー

 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_SHAREDLOCK]

MRxLowIOSubmit[LOWIO_OP_UNLOCK]

MRxLowIOSubmit[LOWIO_OP_UNLOCK_MULTIPLE]

MRxLowIOSubmit[LOWIO_OP_WRITE]

RxReleaseFcbResourceForThreadInMRx