次の方法で共有

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

こちらもご覧ください

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification