次の方法で共有


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