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,并将传递给 NdisFilterHandle 参数的 NDIS 传递给 FilterAttach 的句柄。 NdisFSetAttributesFilterModuleContext 参数指定此筛选器模块的上下文区域。 NDIS 在对函数(如 filterSendNetBufferLists)的调用中将上下文区域传回筛选器驱动程序。

要求

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

另请参阅

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES