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

Статья
12/21/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 если они намерены использовать уже существующий быстрый объект мьютекса. Если FastMutexNULL, вызывающий объект должен явно задать элемент FastMutex объекта контекста потока, чтобы указать на существующий быстрый мьютекс. (Это можно сделать до или после вызова FsRtlSetupAdvancedHeader.)

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

Никакой

Замечания

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP
целевая платформа	Настольный
заголовка	ntifs.h (include Ntifs.h, Fltkernel.h)
IRQL	<= APC_LEVEL