RxStartMinirdr 関数 (mrx.h)

[アーティクル]
10/11/2023

RxStartMinirdr は、RDBSS に登録するために以前に呼び出されたネットワークミニリダイレクターを起動するために呼び出されます。 RxStartMinirdr の一部として、ドライバーが UNC 名のサポートを示している場合、RDBSS はネットワークミニリダイレクタードライバーを汎用名前付け規則 (UNC) プロバイダーとして複数 UNC プロバイダー (MUP) に登録します。

構文

NTSTATUS RxStartMinirdr(
  [in]  IN PRX_CONTEXT RxContext,
  [out] OUT PBOOLEAN   PostToFsp
);

パラメーター

[in] RxContext

デバイスオブジェクトを取得し、これがファイルシステムプロセスであるかどうかを判断するために使用するRX_CONTEXT構造体へのポインター。

[out] PostToFsp

ファイルシステムプロセスによって後で処理するために要求をポストする必要がある場合は、戻り値として TRUE に設定された論理値へのポインター。

戻り値

RxStartMinirdr は、スタートアップシーケンスが成功した場合、または次のいずれかのエラー値がSTATUS_SUCCESSを返します。

リターンコード	説明
STATUS_ACCESS_DENIED	アクセスが拒否されたため、UNC プロバイダーとして登録する要求が失敗しました。
STATUS_ACCESS_VIOLATION	UNC プロバイダーとして登録する要求がアクセス違反で失敗しました。
STATUS_INSUFFICIENT_RESOURCES	このルーチンを完了するにはリソースが不足していました。
STATUS_PENDING	RDBSS とネットワークミニリダイレクターのスタートアップシーケンスは、ユーザーモードのアプリケーションプロセスではなく、システムプロセスのコンテキストで完了する必要があります。 RxStartMinirdr の呼び出しがユーザーモードプロセス (ユーザーモードサービス要求など) から送信された場合、要求は RDBSS 内で後で処理するためにポストされ、STATUS_PENDINGが返されます。このエラーは、特定の内部 RDBSS ロックを待機せずに取得できない場合にも返すことができます。呼び出しは、後でシステムスレッドから完了します。
STATUS_REDIRECTOR_STARTED	ネットワークミニリダイレクターは既に開始されています。

注釈

ネットワークミニリダイレクターは、ドライバーがカーネルによって読み込まれるたびに RDBSS に登録し、ドライバーがアンロードされたときに RDBSS で登録を解除します。ネットワークミニリダイレクターは、RDBSS からエクスポートされた登録ルーチン RxRegisterMinirdr を呼び出すことによって読み込まれたことを RDBSS に通知します。この登録プロセスの一環として、ネットワークミニリダイレクターは、ネットワークミニリダイレクターの構成情報と、ネットワークミニリダイレクタードライバーによって実装されたコールバックルーチンへのポインターのテーブルを含む、大きな構造のMINIRDR_DISPATCHへのポインターである RxRegisterMinirdr にパラメーターを渡します。 RDBSS では、この構造体で渡されたコールバックルーチンを使用して、ネットワークミニリダイレクターと通信します。

ネットワークミニリダイレクターは、MINIRDR_DISPATCH構造体で渡されたコールバックルーチンの 1 つである MRxStart ルーチンの呼び出しを受け取るまで、実際には操作を開始しません。 MrxStart コールバックルーチンは、ネットワークミニリダイレクターが独自のドライバーディスパッチエントリポイントを保持しない限り、操作のコールバックルーチンを受信する場合は、ネットワークミニリダイレクタードライバーによって実装する必要があります。それ以外の場合、RDBSS では、 MrxStart が正常に返されるまで、ドライバーへの次の I/O 要求パケットのみが許可されます。

IRPSP の FileObject-FileName.Length パラメーターが 0 で、FileObject-RelatedFileObject>> パラメーターが NULL であるデバイス作成操作とデバイス操作に対する IRP 要求。

その他の IRP 要求の場合、RDBSS ディスパッチルーチン RxFsdDispatch は、STATUS_REDIRECTOR_NOT_STARTEDの状態を返します。

RDBSS ディスパッチルーチンは、次の I/O 要求パケットに対する要求も失敗します。

IRP_MJ_CREATE_MAILSLOT
IRP_MJ_CREATE_NAMED_PIPE

ネットワークミニリダイレクター MrxStart ルーチンは、 RxStartMinirdr ルーチンが呼び出されたときに RDBSS によって呼び出されます。 RDBSS RxStartMinirdr ルーチンは、通常、ネットワークミニリダイレクターを開始するユーザーモードのアプリケーションまたはサービスからの FSCTL または IOCTL 要求の結果として呼び出されます。 RxRegisterMinirdr の呼び出しが成功した後、ネットワークミニリダイレクターの DriverEntry ルーチンから RxStartMinirdr を呼び出すことはできません。これは、一部の開始処理でドライバーの初期化が完了する必要があるためです。

RDBSS がユーザーモードからネットワークミニリダイレクタードライバーに送信された FSCTL または IOCTL 要求を受信すると、RDBSS はRX_CONTEXT構造体を作成し、この呼び出しをネットワークミニリダイレクターの MRxLowIOSubmit[LOWIO_OP_FSCTL] または MRxLowIOSubmit[LOWIO_OP_IOCTL] MINIRDR_DISPATCH構造体で定義されたコールバックルーチンに渡します。このコールバックルーチンのネットワークミニリダイレクターの実装は、 RxStartMinirdr を開始して呼び出す要求を認識します。イベントのこの通常のプロセスの詳細を以下に示します。

ユーザーモードアプリケーションは、プライベート FSCTL または IOCTL 要求を発行して、ネットワークミニリダイレクターを開始します。
RDBSS カーネルドライバーは、RDBSS が RDBSS 内部ルーチンを指すミニリダイレクタードライバーのドライバーディスパッチエントリポイントを置き換えたため、ネットワークミニリダイレクターに代わって FSCTL または IOCTL 要求を受け取ります。これは、ネットワークミニリダイレクターが RxRegisterMinirdr を呼び出すときに Controls パラメーターにRX_REGISTERMINI_FLAG_DONT_INIT_DRIVER_DISPATCHを設定しなかったことを前提としています。 RxRegisterMinirdr に渡されるこのオプションは通常とは異なるものであり、ネットワークミニリダイレクターが RDBSS でドライバーディスパッチエントリポイントを置き換えることを望まないことを示します。
RDBSS は、ネットワークリダイレクターに代わって、FSCTL または IOCTL 要求を内部的に受信します。 RDBSS ディスパッチャーは、RX_CONTEXT構造体を割り当てて初期化します。次に、RDBSS は、このネットワークミニリダイレクターのMINIRDR_DISPATCH構造で定義されているネットワークミニリダイレクター MRxLowIOSubmit[LOW_OP_FSCTL] または MRxLowIOSubmit[LOW_OP_IOCTL] ルーチンを呼び出し、初期化されたRX_CONTEXT構造体をパラメーターとして渡します。
このコールバックルーチンのネットワークミニリダイレクターの実装では、RxStartMinirdr を開始および呼び出すためのプライベート FSCTL または IOCTL 要求を認識し、RDBSS から受信したRX_CONTEXT構造体を RxContext パラメーターとして渡し、RxContext の PostToFSP メンバーのアドレスを PostToFsp パラメーターとして渡します。
この呼び出しはユーザーモードから開始されたため、 RxStartMinirdr はSTATUS_PENDINGを返し 、PostToFsp を TRUE に設定します。
ネットワークミニリダイレクター MRxLowIOSubmit[LOW_OP_FSCTL] または MRxLowIOSubmit[LOW_OP_IOCTL] ルーチンは、この戻り値を受け取り、RDBSS ディスパッチャーに返します。
RDBSS ディスパッチャーは、STATUS_PENDING戻り値を受け取り 、PostToFsp を TRUE に設定し、ワーカースレッドに要求を送信して、ネットワークミニリダイレクターへの呼び出しを再実行します。

この時点以降、FSCTL または IOCTL が非同期操作または同期操作として要求されたかどうかに基づいて、2 つの結果が得られます。

これが非同期要求の場合は、次の処理が行われます。

ユーザーモードの呼び出し元は、呼び出しからSTATUS_PENDING応答を受け取ります。ポストされたワーカースレッドは、最終的にファイルシステムスレッドから RxStartMinirdr を呼び出し、呼び出しが処理されます。 RxStartMinirdr ルーチンは、要求された場合、ネットワークミニリダイレクターを UNC プロバイダーとして登録しようとします。 Windows Vista より前のバージョンの Windows では、RDBSS はネットワークミニリダイレクターをファイルシステムとして I/O マネージャーに登録しようとします。これらの呼び出しが成功した場合、 RxStartMinirdr は、ネットワークミニリダイレクターによって実装された MrxStart コールバックルーチンを呼び出します。 MrxStart からの戻り値は、最終的に、呼び出しシーケンスプロセスを非同期操作として開始したユーザーモードアプリケーションに返されます。

これが同期要求の場合は、次の処理が行われます。

ユーザーモードの呼び出し元は、STATUS_PENDING応答を受け取りませんが、ポストされたワーカースレッドから呼び出しが返されるまで強制的に待機します。ポストされたワーカースレッドは、最終的にファイルシステムスレッドから RxStartMinirdr を呼び出し、呼び出しが処理されます。 RxStartMinirdr ルーチンは、要求された場合、ネットワークミニリダイレクターを UNC プロバイダーとして登録しようとします。 Windows Vista より前のバージョンの Windows では、RDBSS はネットワークミニリダイレクターをファイルシステムとして I/O マネージャーに登録しようとします。これらの呼び出しが成功した場合、 RxStartMinirdr は、ネットワークミニリダイレクターによって実装された MrxStart コールバックルーチンを呼び出します。 MrxStart からの戻り値は、呼び出しシーケンスプロセスを開始したユーザーモードアプリケーションに返されます。

ネットワークミニリダイレクターが RDBSS (Controls パラメーターを RxRegisterMinirdr に対する Controls パラメーター) に登録するときに UNC のサポートを示す場合、RxStartMinirdr は、ネットワークミニリダイレクターの DeviceName パラメーターを MUP を持つ UNC プロバイダーとして登録しようとします (RDBSS は、ネットワークミニリダイレクターの代わりに FsRtlRegisterUncProvider を呼び出します)。

Windows Vista より前のバージョンの Windows では、 RxStartMinirdr によってファイルシステムが I/O マネージャーに登録されます (RDBSS は、ネットワークミニリダイレクターの代わりに IoRegisterFileSystem を呼び出します)。

呼び出しが成功した場合、 RxStartMinirdr はネットワークミニリダイレクター MrxStart ルーチンを 呼び出します。 MrxStart が成功を返した場合、RDBSS のミニリダイレクターの内部状態は RDBSS_STARTED に設定されます。ミニリダイレクターデバイスオブジェクトの StartStopContext.Version メンバーもインクリメントされます。

RDBSS とネットワークミニリダイレクターのスタートアップシーケンスは、非同期操作が要求された場合、システムプロセスのコンテキストで完了する必要があります。 RxStartMinirdr の呼び出しがユーザーモードプロセス (ユーザーモードサービス要求など) から送信された場合、要求は RDBSS によって内部的に作業キューにポストされ、後で処理するためにSTATUS_PENDINGが返され、PostToFsp パラメーターが TRUE に設定されます。また、待機せずに特定の内部 RDBSS ロックを取得できない場合は、STATUS_PENDINGが返され 、PostToFsp が TRUE に設定されます。 STATUS_PENDINGが返されると、 RxStartMinirdr がシステムプロセス内から再度呼び出されます。 RxStartMinirdr への呼び出しを開始した FSCTL または IOCTL 要求が非同期操作に設定されている場合、RDBSS は呼び出しチェーンをユーザーモードから元の FSCTL または IOCTL 要求にSTATUS_PENDINGバックアップします。一方、FSCTL または IOCTL 要求が同期操作用の場合、呼び出しは後で実行するために作業スレッドにもポストされますが、FSCTL または IOCTL 呼び出しは、 RxStartMinirdr がファイルシステムプロセスのコンテキストで実行されるまでユーザーモードに戻りません。この場合、FSCTL または IOCTL の呼び出し元にSTATUS_PENDINGエラーが返されることはありません。より一般的な動作は、ユーザーモードのアプリケーションコードを簡略化するために、これらの開始/停止操作の同期要求を開始することです。

異常終了またはその他の障害が発生した場合、 RxStartMinirdr は、UNC プロバイダーの MUP への登録解除、ファイルシステムの登録解除、mailslot ブロードキャストで使用されるドメイン名の格納に割り当てられたメモリの解放、内部 RDBSS テーブルの更新など、これらの操作を元に戻そうとします。