Функция FsRtlInsertPerStreamContext (ntifs.h)
Подпрограмма 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:
Код возврата | Описание |
---|---|
|
Вызов FsRtlInsertPerStreamContext выполнен успешно. |
|
Базовая файловая система не поддерживает контексты фильтров. |
Комментарии
Драйвер фильтра файловой системы вызывает FsRtlInsertPerStreamContext , чтобы связать собственную структуру контекста каждого потока с потоком файлов. Структура контекста каждого потока содержит сведения о контексте, которые драйвер фильтра сохраняет для файлового потока.
После того как структура контекста каждого потока будет связана с файловым потоком, ее можно получить, вызвав FsRtlLookupPerStreamContext или удалив метод FsRtlRemovePerStreamContext.
Дополнительные сведения см. в статье Отслеживание Per-Stream контекста в устаревшем драйвере фильтра файловой системы.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Накопительный пакет обновления Windows 2000 с пакетом обновления 4 (SP4); Windows XP |
Целевая платформа | Универсальное |
Верхняя часть | ntifs.h (включая Ntifs.h) |
Библиотека | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
См. также раздел
FsRtlGetPerStreamContextPointer