次の方法で共有

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
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

IoRegisterPlugPlayNotification の

IoUnregisterPlugPlayNotification