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

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

  • Статья

Подпрограмма FsRtlInsertPerFileContext связывает объект FSRTL_PER_FILE_CONTEXT с объектом контекста, заданным драйвером для файла.

Синтаксис

NTSTATUS FsRtlInsertPerFileContext(
  [in] PVOID                   *PerFileContextPointer,
  [in] PFSRTL_PER_FILE_CONTEXT Ptr
);

Параметры

[in] PerFileContextPointer

Указатель на непрозрачный указатель, используемый пакетом библиотеки среды выполнения файловой системы (FSRTL) для отслеживания контекстов файлов. Чтобы получить этот указатель из объекта файла, используйте макрос FsRtlGetPerFileContextPoint er.

[in] Ptr

Указатель на структуру контекста для конкретного драйвера.

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

Подпрограмма FsRtlInsertPerFileContext возвращает STATUS_SUCCESS или соответствующий код ошибки, например:

Возвращаемый код Описание
STATUS_INVALID_DEVICE_REQUEST
 Базовая файловая система не поддерживает контексты файлов фильтра. Вы можете использовать макрос FsRtlSupportsPerFileContexts, чтобы проверить, поддерживает ли файловая система объекты контекста для каждого файла.
STATUS_INSUFFICIENT_RESOURCES
 Система не могла выделить ресурсы (обычно память).

Замечания

Макрос FsRtlGetPerFileContextPointer возвращает FileContextSupportPointer для открытого файла.

Параметры

FileObject

FILE_OBJECT

Указатель на объект файла.

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

PVOID

Макрос FsRtlGetPerFileContextPointer возвращает непрозрачный указатель, используемый пакетом библиотеки среды выполнения файловой системы (FSRTL) для отслеживания контекстов файлов. Макрос возвращает NULL, если файловая система не поддерживает использование объектов контекста для каждого файла с файлами.

Макрос FsRtlGetPerFileContextPointer возвращает указатель, передаваемый в подпрограммы, такие как FsRtlInsertPerFileContext, FsRtlLookupPerFileContextи FsRtlRemovePerFileContext.

Дополнительные сведения об использовании и создании объектов контекста см. в разделе Отслеживание Per-File контекста вдрайвера фильтра устаревшей файловой системы.

Требования

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

См. также

FSRTL_PER_FILE_CONTEXT

FsRtlLookupPerFileContext

FsRtlRemovePerFileContext

контекст отслеживания Per-File в устаревшем драйвере фильтра файловой системы