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

Статья
03/08/2023

Подпрограмма 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 возвращает состояние уведомления.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также раздел

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotification

Share via