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

Драйверы фильтров файловой системы и файловые системы вызывают FsRtlRegisterFileSystemFilterCallbacks подпрограммы для регистрации подпрограмм обратного вызова уведомлений, которые будут вызываться при выполнении определенных операций базовой файловой системы.

Синтаксис

NTSTATUS FsRtlRegisterFileSystemFilterCallbacks(
  [in] _DRIVER_OBJECT       *FilterDriverObject,
  [in] PFS_FILTER_CALLBACKS Callbacks
);

Параметры

[in] FilterDriverObject

Указатель на объект драйвера для драйвера фильтра или драйвера файловой системы.

[in] Callbacks

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

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

FsRtlRegisterFileSystemFilterCallbacks подпрограмма может возвращать одно из следующих значений состояния:

Замечания

Драйверы фильтров файловой системы и файловой системы должны вызывать FsRtlRegisterFileSystemFilterCallbacks из подпрограммы драйвера DriverEntry.

FsRtlRegisterFileSystemFilterCallbacks регистрирует подпрограммы обратного вызова уведомлений, указанные в параметре обратного вызова , вызываемые при отправке запросов на определенные операции с файлами в базовую файловую систему.

Файловые системы вызывают FsRtlRegisterFileSystemFilterCallbacks, чтобы задать preAcquireForSectionSynchronization член обратного вызова структуры FS_FILTER_CALLBACKS вместо использования устаревшей AcquireFileForNtCreateSection.

Подпрограммы обратного вызова, зарегистрированные FsRtlRegisterFileSystemFilterCallbacks заменяют следующие быстрые подпрограммы обратного вызова ввода-вывода, которые устарели и не должны использоваться драйверами фильтров файловой системы:

• AcquireForCcFlush
• AcquireFileForNtCreateSection
• AcquireForModWrite
• ReleaseForCcFlush
• ReleaseFileForNtCreateSection
• ReleaseForModWrite

Требования

См. также

FS_FILTER_CALLBACKS