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