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 を呼び出すことによって、この通知に登録されているファイル システム フィルター ドライバーの通知ルーチンを呼び出 します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |
こちらもご覧ください
IoRegisterFsRegistrationChange