RxDriverEntry 関数 (rxprocs.h)

[アーティクル]
08/07/2023

RxDriverEntry は、RDBSS 静的ライブラリを初期化するために 、DriverEntry ルーチンからモノリシックネットワークミニリダイレクタードライバーによって呼び出されます。

モノリシックでないドライバーの場合、この初期化ルーチンは、RDBSS.SYS デバイスドライバーの DriverEntry ルーチンと 同じです。

構文

NTSTATUS RxDriverEntry(
  [in] IN PDRIVER_OBJECT  DriverObject,
  [in] IN PUNICODE_STRING RegistryPath
);

パラメーター

[in] DriverObject

ネットワークミニリダイレクタードライバーのドライバーオブジェクトへのポインター。各ドライバーは、 DriverEntry ルーチンへのパラメーターで、ドライバーオブジェクトへのポインターを受け取ります。このドライバーオブジェクトは、ネットワークミニリダイレクタードライバーのデバイスオブジェクトを作成するために使用されます。

[in] RegistryPath

ドライバーパラメーターとその他の構成データが格納される場所へのレジストリパスを含む Unicode 文字列へのポインター。このレジストリパスは、通常、 HKLM\System\CurrentControlSet\Services キーの下にある特定のネットワークミニリダイレクターのサービスエントリの下にあります。

戻り値

RxDriverEntry は、成功した場合はSTATUS_SUCCESS、失敗した場合は次のいずれかのエラー値を返します。

リターンコード	説明
RXINIT_START	RDBSS の初期化が開始されましたが、エラーが発生しました。このエラーコードは、値が 5 の内部 RDBSS 列挙型です。

注釈

RDBSSLIB と静的にリンクされているモノリシックネットワークミニリダイレクタードライバー。LIB は、ドライバーにリンクされている RDBSSLIB ライブラリのコピーを初期化するために、DriverEntry ルーチンから RxDriverEntry を呼び出す必要があります。 RxDriverEntry は、他の RDBSS ルーチンが呼び出される前に、モノリシックネットワークミニリダイレクタードライバーによって呼び出される必要があります。

RxDriverEntry を呼び出して、DriverEntry ルーチンの開始時近くに RDBSS ライブラリのコピーを初期化した後、ネットワークミニリダイレクタードライバーは通常、後で DriverEntry ルーチンで RxRegisterMinirdr を呼び出して RDBSS に登録します。

RxDriverEntry 呼び出しが成功すると、内部グローバル RDBBS データ構造が初期化されます。これらのデータ構造を保護するために、さまざまなスピンロックとミューテックスが作成されます。これらのデータ構造の 1 つは、RDBSS メモリデータ構造の最上位構造であるRDBSS_DATA構造です。 DriverObject パラメーターは、RDBSS_DATA構造体の DriverObject メンバーに格納されます。 RxDriverEntry では、トレース、ログ記録、デバッグも初期化されます (たとえば、チェックされたビルド)。

RxDriverEntry は、 RegistryPath パラメーターとして渡されたレジストリパスを開こうとし、このオブジェクトを大文字と小文字を区別しない文字列として扱います。このレジストリキーを正常に開くことができる場合は、このエントリの下にある Parameters レジストリキーを開こうとします。

RxDriverEntry では、 HKLM\System\CurrentControlSet\Services\LanmanWorkStation\Parameters レジストリキーも開こうとします。

このキーを開くことができる場合は、オペレーティングシステムのバージョンに応じて、このキーの下にある値の読み取りが試行されます。

Windows XP 以降では、RxDriverEntry は LanmanWorkStation\Parameters キーの下にある DisableByteRangeLockingOnReadOnlyFiles 値を開こうとします。

この値は、ブール値として扱われ、読み取り専用ファイルでバイト範囲ロックを処理するための RDBSS 変数 DisableByteRangeLockingOnReadOnlyFiles のブール値として格納される DWORD です。この変数は、RDBSS が FCB 上のネットワークミニリダイレクターによる新しいSRV_OPEN要求を処理する方法に影響し、属性に互換性がある場合に既存のSRV_OPENに折りたたむことができるかどうかを決定します。ネットワークミニリダイレクタードライバーでこの動作を変更する場合、 ドライバーは、RxDriverEntry ルーチンが返された後、DisableByteRangeLockingOnReadOnlyFiles の値を適切な値に設定する必要があります。 RDBSSLIB。LIB 静的ライブラリは、DisableByteRangeLockingOnReadOnlyFiles を外部変数として公開します。

Windows 2000 および Windows XP では、RxDriverEntry は LanmanWorkStation\Parameters キーの下の ReadAheadGranularity 値を開こうとします。

この値は、キャッシュマネージャーで使用される先読み用のPAGE_SIZEページ数に対する内部 RDBSS オプションの値として、数値として扱われ、格納される DWORD です。 16 より大きいレジストリ値は、この値が 16 (現在許可されている最大値) に制限されているかのように扱われます。この内部オプションは、プロセッサのPAGE_SIZEのページ数として格納されます (たとえば、4K PAGE_SIZEの場合は最大0x10000または 64K)。 Windows 2000 および Windows XP では、RDBSS は CcSetReadAheadGranularity を呼び出し、さまざまな作成、読み取り、書き込み操作に対してこのオプションを使用します。ネットワークミニリダイレクタードライバーがこの動作を変更する場合、 ドライバーは、RxDriverEntry ルーチンが返された後、適切な値に ReadAheadGranularity の値を設定する必要があります。 RDBSSLIB。LIB 静的ライブラリは、ReadAheadGranularity を外部変数として公開します。

X86 システムでは、ページング書き込みを発行するときにメモリマネージャーによって発行される最大の書き込みは 64K です (キャッシュのフラッシュは、メモリマネージャーを介したページング書き込みになります)。リモートファイルシステムの場合、64K は最適な選択肢ではありません。 1 つの TDI ネットワーク要求で転送できるデータの大部分は、プロトコル情報のオーバーヘッドのため、64,000 未満になります。

Windows Server 2003 では、ReadAheadGranularity を設定するレジストリ値は公開されず、RDBSS の既定値は 32K (8 4K PAGE_SIZE ページ) です。これは、ローカルファイルシステムに採用されているのと同じ既定値です。

RxDriverEntry は、PsGetCurrentProcess を呼び出して実行されているカーネルプロセスへのポインターを取得し、この値を内部 RDBSS データ構造に格納します。このカーネルプロセスは、ファイルシステムプロセスと呼ばれることもあります。

その後、RxDriverEntry は、ドライバーディスパッチテーブル内のすべてのエントリに対して RxFsdDispatch ルーチンへのポインターをコピーします。そのため、モノリシックネットワークミニリダイレクタードライバーが RDBSS ライブラリの前に特別な処理のために特定の IRP を受信する必要がある場合は、 RxDriverEntry を呼び出す前に元のドライバーディスパッチテーブルのコピーと 、RxDriverEntry の呼び出しが返された後に復元されたルーチンポインターを保存する必要があります。この動作を防ぐオプションが設定されていない限り、RXRegisterMinirdr が呼び出されると、RDBSS は RxFsdDispatch をすべてのドライバーディスパッチテーブルエントリにコピーします。

モノリシックでないネットワークミニリダイレクタードライバー (Microsoft SMB リダイレクター) の場合、RDBSS.SYS デバイスドライバーは、RxDriverEntry を内部的に呼び出す読み込まれるときに、独自の DriverEntry ルーチンで初期化されます。モノリシックドライバーでは、 RxDriverEntry ルーチンが RDBSSLIB からエクスポートされます。LIB 静的ライブラリとは、ネットワークミニリダイレクターによって明示的に呼び出される必要があります。