FwpsAcquireWritableLayerDataPointer0 函数 (fwpsk.h)

项目
02/29/2024

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

分类Fn 函数的筛选器参数的 FilterId 成员的值。有关 FilterId 成员的详细信息，请参阅 FWPS_FILTER1。

[in] flags

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

[out] writableLayerData

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

[in, out] classifyOut

设置为标注驱动程序的分类 Fn 函数的分类输出参数。分类Fn 的 分类输出 参数作为输出参数列在标头中，但它包含足够的输入信息，在传递给 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 (包括 Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL