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

Статья
03/01/2024

Подпрограмма FsRtlLookupPerFileContext возвращает указатель на объект FSRTL_PER_FILE_CONTEXT , связанный с указанным файлом.

Синтаксис

PFSRTL_PER_FILE_CONTEXT FsRtlLookupPerFileContext(
  [in]           PVOID *PerFileContextPointer,
  [in, optional] PVOID OwnerId,
  [in, optional] PVOID InstanceId
);

Параметры

[in] PerFileContextPointer

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

[in, optional] OwnerId

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

[in, optional] InstanceId

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

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

Указатель на первую FSRTL_PER_FILE_CONTEXT структуру, соответствующую Идентификатору владельца и Идентификатору экземпляра , если указано значение, или ЗНАЧЕНИЕ NULL , если совпадение не найдено или файловая система не поддерживает контексты для каждого файла.

Если файловая система не поддерживает объекты контекста для каждого файла, возвращается значение NULL . Используйте макрос FsRtlSupportsPerFileContexts , чтобы определить, поддерживает ли файловая система объекты контекста для каждого файла.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая FltKernel.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL