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

Статья
12/21/2024

Подпрограмма FsRtlInsertPerStreamContext связывает драйвер фильтра файловой системы в контекстной структуре потока с потоком.

Синтаксис

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

Параметры

PerStreamContext

Указатель на структуру FSRTL_ADVANCED_FCB_HEADER для потока файлов. Чтобы получить этот указатель из объекта файла, используйте макрос FsRtlGetPerStreamContextPointer.

[in] Ptr

Указатель на структуру FSRTL_PER_STREAM_CONTEXT, выделенную и инициализированную драйвером фильтра. Чтобы инициализировать эту структуру, используйте макрос FsRtlInitPerStreamContext.

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

FsRtlInsertPerStreamContext возвращает одно из следующих значений NTSTATUS:

Возвращаемый код	Описание
STATUS_SUCCESS	Вызов FsRtlInsertPerStreamContext был успешным.
STATUS_INVALID_DEVICE_REQUEST	Базовая файловая система не поддерживает контексты фильтров.

Замечания

Драйвер фильтра файловой системы вызывает FsRtlInsertPerStreamContext связать собственную структуру контекста потока с потоком. Структура контекста потока содержит сведения о контексте, которые драйвер фильтра поддерживает для потока файлов.

После связи структуры контекста потока с файловым потоком его можно получить путем вызова FsRtlLookupPerStreamContext или удаления путем вызова FsRtlRemovePerStreamContext.

Дополнительные сведения см. в контексте отслеживания Per-Stream вустаревшего драйвера фильтра файловой системы.

Требования

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