FsRtlNotifyVolumeEvent 関数 (ntifs.h)
FsRtlNotifyVolumeEvent ルーチンは、ボリューム イベントが発生していることを登録済みアプリケーションに通知します。
構文
NTSTATUS FsRtlNotifyVolumeEvent(
[in] PFILE_OBJECT FileObject,
[in] ULONG EventCode
);
パラメーター
[in] FileObject
指定されたボリュームのファイル オブジェクトへのポインター。
[in] EventCode
発生しているイベントのイベント コードを指定します。 このコードには、次のいずれかの値を指定できます。
| イベント コード | PnP イベント GUID | 意味 |
|---|---|---|
| FSRTL_VOLUME_BACKGROUND_FORMAT | GUID_IO_VOLUME_BACKGROUND_FORMAT | バックグラウンド形式の操作が開始されました。 |
| FSRTL_VOLUME_CHANGE_SIZE | GUID_IO_VOLUME_CHANGE_SIZE | ボリューム上のファイル システムのサイズが変更されました。 Windows Server 2003 および Windows XP/2000 の場合、この値はサポートされていません。 |
| FSRTL_VOLUME_DISMOUNT | GUID_IO_VOLUME_DISMOUNT | ボリュームがマウント解除されています。 |
| FSRTL_VOLUME_DISMOUNT_FAILED | GUID_IO_VOLUME_DISMOUNT_FAILED | ボリュームのマウント解除に失敗しました。 |
| FSRTL_VOLUME_FORCED_CLOSED | GUID_IO_VOLUME_FORCE_CLOSED | ボリュームは、ファイル システムによって読み取り専用になっています。 このフラグは、Windows Vista 以降で使用できます。 |
| FSRTL_VOLUME_INFO_MAKE_COMPAT | GUID_IO_VOLUME_INFO_MAKE_COMPAT | ボリューム メディアは削除されましたが、互換性のない状態であり、別のリムーバブル メディア ストレージ デバイスでは読み取れない可能性があります。 このフラグは、Windows Vista 以降で使用できます。 |
| FSRTL_VOLUME_LOCK | GUID_IO_VOLUME_LOCK | ボリュームがロックされています。 |
| FSRTL_VOLUME_LOCK_FAILED | GUID_IO_VOLUME_LOCK_FAILED | ボリューム ロックに失敗しました。 |
| FSRTL_VOLUME_MOUNT | GUID_IO_VOLUME_MOUNT | ボリュームがマウントされています。 |
| FSRTL_VOLUME_NEEDS_CHKDSK | GUID_IO_VOLUME_NEED_CHKDSK | ボリュームでデータの破損が検出され、Chkdsk を実行して修正する必要があります。 このフラグは、Windows Vista 以降で使用できます。 |
| FSRTL_VOLUME_PREPARING_EJECT | GUID_IO_VOLUME_PREPARING_EJECT | ファイル システムは、取り出すディスクを準備しています。 Windows Server 2003 および Windows XP/2000 の場合、この値はサポートされていません。 |
| FSRTL_VOLUME_UNLOCK | GUID_IO_VOLUME_UNLOCK | ボリュームのロックが解除されています。 |
| FSRTL_VOLUME_WEARING_OUT | GUID_IO_VOLUME_WEARING_OUT | ボリューム メディアが摩耗しています。このフラグは、Windows Vista 以降で使用できます。 |
| FSRTL_VOLUME_WORM_NEAR_FULL | GUID_IO_VOLUME_WORM_NEAR_FULL | ボリュームは書き込み 1 回の読み取り多 (WORM) ボリュームであり、ほぼいっぱいです。 このフラグは、Windows Vista 以降で使用できます。 |
戻り値
FsRtlNotifyVolumeEvent は 、通知の状態を返します。
注釈
ファイル システムは FsRtlNotifyVolumeEvent を呼び出して、ボリューム イベントが発生していることを登録済みのユーザー モード アプリケーションに通知します。
PnP イベント GUID 値は、Ioevent.h で定義されます。
ボリューム イベント通知に登録するには、アプリケーションで Microsoft Win32 RegisterDeviceNotification 関数を呼び出す必要があります。 詳細については、Microsoft Windows SDKドキュメントの「デバイス管理」セクションを参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP |
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |