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

Статья
12/21/2024

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

Синтаксис

void FsRtlSetupAdvancedHeaderEx(
   _advhdr,
   _fmutx,
   _fctxptr
);

Параметры

_advhdr

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

_fmutx

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

_fctxptr

Указатель на поле указателя, используемое библиотекой среды выполнения файловой системы (FSRTL) для отслеживания контекстов файлов. Этот параметр является необязательным и может быть null. В частности:

Для операционных систем Microsoft Windows, выпущенных до Windows Vista, вызывающие серверы должны задать для этого параметра значение NULL.
Для операционных систем Windows, начиная с Windows Vista: если FileContextSupportPointer не NULL, FileContextSupportPointer должен быть указателем на переменную PVOID внутри структуры файловой системы, создающей структуру файлов. Чтобы указать, что драйвер файловой системы не поддерживает контексты файлов, вызывающие элементы должны задать FileContextSupportPointer значение NULL.

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

Никакой

Замечания

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

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

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

Требования

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