FwpsAcquireWritableLayerDataPointer0 函数（fwpsk.h）

项目
02/07/2025

FwpsAcquireWritableLayerDataPointer0 函数返回可以检查和更改的特定于层的数据。

注释FwpsAcquireWritableLayerDataPointer0 是 FwpsAcquireWritableLayerDataPointer的特定版本。有关详细信息，请参阅 WFP 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 成员的值。有关 FilterId 成员的详细信息，请参阅 FWPS_FILTER1。

[in] flags

保留以供将来使用。设置为零。

[out] writableLayerData

包含层可修改数据的数据缓冲区。以下“备注”部分中列出的受支持的数据类型定义为结构。返回时，可以通过将 void 指针强制转换为适当的结构类型来访问数据。

[in, out] classifyOut

设置为标注驱动程序的 classifyFn 函数的 classifyOut 参数。 classifyOut 参数在标头中列为输出参数，但它包含足够的有关输入的信息，在传递给 FwpsAcquireWritableLayerDataPointer0时，该参数对引擎非常有用。

返回值

FwpsAcquireWritableLayerDataPointer0 函数返回以下 NTSTATUS 代码之一。

返回代码	描述
STATUS_SUCCESS	已成功注册回调函数。
其他状态代码	发生错误。

言论

FwpsAcquireWritableLayerDataPointer0 设置 FWPS_CLASSIFY_OUT0 结构的以下成员：

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->权限 &= ~FWPS_RIGHT_ACTION_WRITE

每次调用此函数时，都必须对 FwpsApplyModifiedLayerData0 进行匹配调用，才能完成所做的更改，即使标注驱动程序未修改任何数据。如果不调用 FwpsApplyModifiedLayerData0，这可能会导致分类未正确完成。

定义以下结构以包含可修改的层数据。输出上设置为 writableLayerData 参数的指针可以转换为以下类型之一：

要求

要求	价值
最低支持的客户端	从 Windows 7 开始可用。
目标平台	普遍
标头	fwpsk.h （包括 Fwpsk.h）
库	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL