Функция FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Статья
08/07/2023

Функция FwpsAcquireWritableLayerDataPointer0 возвращает данные определенного уровня, которые можно проверить и изменить.

ПримечаниеFwpsAcquireWritableLayerDataPointer0 — это определенная версия FwpsAcquireWritableLayerDataPointer. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Синтаксис

NTSTATUS FwpsAcquireWritableLayerDataPointer0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [out]     PVOID              *writableLayerData,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Параметры

[in] classifyHandle

Дескриптор для запроса классификации. Этот дескриптор получается путем вызова FwpsAcquireClassifyHandle0.

[in] filterId

Значение элемента FilterId параметра фильтра функции classifyFn. Дополнительные сведения об элементе FilterId см. в разделе FWPS_FILTER1.

[in] flags

Зарезервировано для последующего использования. Задайте нулевое значение.

[out] writableLayerData

Буфер данных, содержащий изменяемые данные для слоя. Поддерживаемые типы данных, перечисленные в следующем разделе примечаний, определяются как структуры. При возврате доступ к данным можно получить, приведение указателя void к соответствующему типу структуры.

[in, out] classifyOut

Задайте для параметра classifyOut функции classifyFn драйвера выноски. Параметр classifyOut classifyFn указан в качестве выходного параметра в заголовке, но он содержит достаточно сведений о входных данных, чтобы быть полезным для обработчика при передаче в FwpsAcquireWritableLayerDataPointer0.

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

Функция FwpsAcquireWritableLayerDataPointer0 возвращает один из следующих кодов NTSTATUS.

Код возврата	Описание
STATUS_SUCCESS	Функция обратного вызова успешно зарегистрирована.
Другие коды состояния	Произошла ошибка.

Для каждого вызова этой функции необходимо выполнить соответствующий вызов FwpsApplyModifiedLayerData0 , чтобы завершить внесенные изменения, даже если драйвер выноски не изменил никаких данных. Если не выполнить вызов FwpsApplyModifiedLayerData0, это может привести к неправильному завершению классификации.

Следующие структуры определяются для хранения изменяемых данных слоя. Указатель, заданный в выходных данных в качестве параметра writableLayerData , можно привести к одному из следующих типов:

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 7.
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
Библиотека	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL