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

Статья
02/29/2024

Макрос FsRtlSetupAdvancedHeader используется файловыми системами для инициализации структуры FSRTL_ADVANCED_FCB_HEADER для использования с контекстами фильтров.

Синтаксис

void FsRtlSetupAdvancedHeader(
  PVOID       AdvHdr,
  PFAST_MUTEX FMutex
);

Параметры

AdvHdr

Указатель на инициализируемый FSRTL_ADVANCED_FCB_HEADER структуру.

FMutex

Указатель на инициализированный быстрый мьютекс, который будет использоваться для синхронизации доступа к FSRTL_ADVANCED_FCB_HEADER структуре. Быстрый мьютекс должен быть выделен из пула без паг.

Этот параметр может принимать значение NULL. Вызывающие объекты должны присвоить этому параметру значение NULL , если они намерены использовать уже существующий объект быстрого мьютекса. Если FastMutex имеет значение NULL, вызывающий объект должен явно задать элемент FastMutex объекта контекста потока, чтобы он указывал на существующий быстрый мьютекс. (Это можно сделать до или после вызова FsRtlSetupAdvancedHeader.)

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

None

Remarks

Файловые системы используют макрос FsRtlSetupAdvancedHeader для инициализации структуры FSRTL_ADVANCED_FCB_HEADER для использования с контекстами фильтров.

Если расширенная структура заголовков FCB больше не требуется, файловая система должна вызывать FsRtlTeardownPerStreamContexts , чтобы освободить все связанные структуры контекста для каждого потока.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Целевая платформа	Персональный компьютер
Верхняя часть	ntifs.h (включая Ntifs.h, Fltkernel.h)
IRQL	<= APC_LEVEL