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

Статья
02/27/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 (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL