NdisFSetAttributes 函数 (ndis.h)

  • 项目

筛选器驱动程序调用 NdisFSetAttributes 函数以指定筛选器模块上下文区域。

语法

NDIS_STATUS NdisFSetAttributes(
  [in] NDIS_HANDLE                  NdisFilterHandle,
  [in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
  [in] PNDIS_FILTER_ATTRIBUTES      FilterAttributes
);

参数

[in] NdisFilterHandle

标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。

[in] FilterModuleContext

此筛选器模块的调用方分配的上下文区域。

[in] FilterAttributes

指向分配的筛选器驱动程序的指针 NDIS_FILTER_ATTRIBUTES 结构。

返回值

NdisFSetAttributes 返回以下状态值之一：

返回代码 说明
NDIS_STATUS_SUCCESS
 如果 NdisFSetAttributes 设置了筛选器驱动程序属性，则返回NDIS_STATUS_SUCCESS。
NDIS_STATUS_RESOURCES
 由于资源不足，NdisFSetAttributes 失败。
NDIS_STATUS_FAILURE
 如果上述值均未应用，则 NdisFSetAttributes 返回NDIS_STATUS_FAILURE。

注解

筛选器驱动程序从其 FilterAttach 函数调用 NdisFSetAttributes，并将 NDIS 传递给 FilterAttach 的句柄在 NdisFilterHandle 参数处传递。 NdisFSetAttributes 的 FilterModuleContext 参数指定此筛选器模块的上下文区域。 NDIS 在调用 FilterSendNetBufferLists 等函数时将上下文区域传回筛选器驱动程序。

要求

要求 值
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Filter_Driver_Function (ndis)

另请参阅

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES