IoRegisterFileSystem 関数 (ntifs.h)

IoRegisterFileSystem ルーチンは、ファイル システムの制御デバイス オブジェクトをグローバル ファイル システム キューに追加します。

構文

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

パラメーター

[in] DeviceObject

ファイル システムのコントロール デバイス オブジェクトへのポインター。

戻り値

なし

解説

IoRegisterFileSystem は 、ファイル システムの制御デバイス オブジェクトをグローバル ファイル システム キューに挿入して、ファイル システムをアクティブ ファイル システムとして登録し、ファイル システムのコントロール デバイス オブジェクトの参照カウントをインクリメントします。

ファイル システム制御デバイス オブジェクトのデバイスの種類は、次のいずれかである必要があります。

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

デバイスの種類がこれらの値の 1 つでない場合、ファイル システムは登録されません。

さらに、ファイル システム制御デバイス オブジェクトの名前を指定する必要があります。 名前が指定されていない場合、 IoRegisterFileSystem の呼び出しは失敗しません。 ただし、ファイル システム フィルター ドライバー、および多くのシステム コンポーネントとサポート ルーチンは、この名前を使用して、常に名前が付けられたファイル システムのコントロール デバイス オブジェクトと、そのボリューム デバイス オブジェクト (名前が指定されない) を区別します。

DO_LOW_PRIORITY_FILESYSTEM フラグがファイル・システムの制御デバイス・オブジェクトに設定されている場合、装置オブジェクトはキュー内の次から最後の位置に挿入されます。 (RAW ファイル システムは、キュー内の最後の位置を占めます)。このフラグが設定されていない場合、デバイス オブジェクトはキューの先頭に挿入されます。

IoRegisterFileSystem は、 IoRegisterFsRegistrationChange または IoRegisterFsRegistrationChangeEx を呼び出すことによって、この通知に登録されているファイル システム フィルター ドライバーの通知ルーチンを呼び出 します。

メモ Microsoft Windows XP 以降では、ファイル システム フィルター ドライバーが IoRegisterFsRegistrationChange を呼び出すと、その通知ルーチンは、既に IoRegisterFileSystem を呼び出したファイル システムに対してもすぐに呼び出されます。

 

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

こちらもご覧ください

IoRegisterFsRegistrationChange

IoRegisterFsRegistrationChangeEx

IoUnregisterFileSystem

IoUnregisterFsRegistrationChange