NdisGetRssProcessorInformation 函数 (ndis.h)

NdisGetRssProcessorInformation 函数检索有关微型端口驱动程序必须用于接收端缩放的处理器集的信息, (RSS) 。

语法

NDIS_STATUS NdisGetRssProcessorInformation(
  [in]            NDIS_HANDLE              NdisHandle,
  [out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
  [in, out]       PSIZE_T                  Size
);

参数

[in] NdisHandle

在调用方初始化期间获取的 NDIS 实例句柄。 NDIS 驱动程序可以使用以下函数中的句柄:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

指向调用方分配的缓冲区的指针,其中 NDIS 放置 NDIS_RSS_PROCESSOR_INFO 结构和包含 RSS 处理器集相关信息 的NDIS_RSS_PROCESSOR 结构数组。 调用方在 Size 参数中提供缓冲区的长度。

[in, out] Size

指向一个值的指针,该值是调用方提供的缓冲区的大小(以字节为单位)。 当函数返回时,此成员包含 NDIS 放入缓冲区中的数据量或缓冲区的所需大小(如果缓冲区太短)。

返回值

NdisGetRssProcessorInformation 可以返回以下状态值之一:

返回代码 说明
NDIS_STATUS_SUCCESS
操作已成功完成。
NDIS_STATUS_BUFFER_TOO_SHORT
在 Size 参数中指定的大小太小。 在这种情况下,NDIS 在 Size 参数中提供所需的缓冲区大小。

注解

NDIS 驱动程序调用 NdisGetRssProcessorInformation 函数,以检索有关接收端缩放 (本地计算机上的 RSS) 处理器的信息。

支持 RSS 的微型端口驱动程序,支持 MSI-X 在其中调用 NdisGetRssProcessorInformation MiniportFilterResourceRequirements 函数。 微型端口驱动程序将分配的 MSI-X 消息的中断相关性设置为 RssProcessorInfo 参数的 RssProcessors 成员中指定的 RSS 处理器。

要求

要求
最低受支持的客户端 在 NDIS 6.20 及更高版本中受支持。
目标平台 通用
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

另请参阅

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx