Макрос FsRtlLookupPerStreamContext (ntifs.h)

Статья
03/05/2024

Макрос FsRtlLookupPerStreamContext извлекает структуру контекста каждого потока для файлового потока.

Синтаксис

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

Параметры

_sc

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

_oid

Указатель на переменную, выделенную вызывающим объектом, которая однозначно идентифицирует владельца структуры контекста потока. Формат этой переменной зависит от драйвера фильтра . Значение должно быть не равно NULL, если для InstanceId задано значение, отличное от NULL.

_iid

Указатель на драйвер фильтра — выделенную переменную, которую можно использовать для различения структур контекста потока, созданных одним и тем же драйвером фильтра. Формат этой переменной зависит от драйвера фильтра .

Если значения OwnerId и InstanceId имеют значение NULL, FsRtlLookupPerStreamContext возвращает первый найденный контекст потока.

Если для OwnerId указано значение, отличное от NULL, а для InstanceId задано значение NULL, функция FsRtlLookupPerStreamContext возвращает первый найденный контекст потока, член Которого OwnerId соответствует параметру OwnerId.

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

None

Remarks

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

Примечание. FsRtlLookupPerStreamContext можно использовать только в файловых системах, поддерживающих контексты каждого потока.

Чтобы инициализировать структуру контекста для каждого потока, используйте макрос FsRtlInitPerStreamContext .

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Накопительный пакет обновления Windows 2000 с пакетом обновления 4 (SP4); Windows XP
Целевая платформа	Персональный компьютер
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL