Функция FsRtlNotifyVolumeEvent (ntifs.h)

Статья
12/21/2024

Программа FsRtlNotifyVolumeEvent уведомляет все зарегистрированные приложения о том, что происходит событие тома.

Синтаксис

NTSTATUS FsRtlNotifyVolumeEvent(
  [in] PFILE_OBJECT FileObject,
  [in] ULONG        EventCode
);

Параметры

[in] FileObject

Указатель на объект файла для заданного тома.

[in] EventCode

Указывает код события для события, которое происходит. Этот код может быть одним из следующих значений.

Код события	GUID события PnP	Значение
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	Том — это том записи один раз, многократный (WORM), и он почти полный. Этот флаг доступен в Windows Vista и более поздних версиях.

Возвращаемое значение

FsRtlNotifyVolumeEvent возвращает состояние уведомления.

Замечания

Файловые системы вызывают FsRtlNotifyVolumeEvent, чтобы уведомить все зарегистрированные приложения в режиме пользователя о том, что происходит событие тома.

Значения GUID событий PnP определяются в Ioevent.h.

Чтобы зарегистрировать уведомление о событиях тома, приложения должны вызывать функцию Microsoft Win32 RegisterDeviceNotification. Дополнительные сведения см. в разделе "Управление устройствами" в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification

Поделиться через