NdisGetRssProcessorInformation 函式（ndis.h）

發行項
02/07/2025

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 訊息的中斷親和性設定為 RssProcess ors 中所指定的 RSS 處理器，RssProcessorInfo 參數的成員。

要求

要求	價值
最低支援的用戶端	NDIS 6.20 和更新版本支援。
目標平臺	普遍
標頭	ndis.h （包括 Ndis.h）
連結庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL