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

Статья
02/07/2025

Функция 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 функции драйвера выноски, классифицируемойFn. Параметр classifyOut classifyFn указан в качестве выходного параметра в заголовке, но он содержит достаточно сведений о входных данных, чтобы быть полезными для подсистемы при передаче в FwpsAcquireWritableLayerDataPointer0.

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

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

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

Замечания

FwpsAcquireWritableLayerDataPointer0 задает следующие элементы структуры FWPS_CLASSIFY_OUT0:

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->rights &= ~FWPS_RIGHT_ACTION_WRITE

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
библиотеки	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL