Freigeben über


NdisGetRssProcessorInformation-Funktion (ndis.h)

Die NdisGetRssProcessorInformation--Funktion ruft Informationen über den Satz von Prozessoren ab, die ein Miniporttreiber für die Empfangsseitige Skalierung (RSS) verwenden muss.

Syntax

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

Parameter

[in] NdisHandle

Ein NDIS-Instanzhandle, das während der Initialisierung des Aufrufers abgerufen wurde. NDIS-Treiber können die Handles aus den folgenden Funktionen verwenden:

MiniportInitializeEx-

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in dem NDIS die NDIS_RSS_PROCESSOR_INFO Struktur und ein Array von NDIS_RSS_PROCESSOR Strukturen platziert, die Informationen zum RSS-Prozessorsatz enthalten. Der Aufrufer stellt die Länge des Puffers im parameter Size bereit.

[in, out] Size

Ein Zeiger auf einen Wert, der die Größe des vom Aufrufer bereitgestellten Puffers in Bytes darstellt. Wenn die Funktion zurückgegeben wird, enthält dieses Element entweder die Datenmenge, die NDIS im Puffer platziert hat, oder die erforderliche Größe des Puffers, wenn der Puffer zu kurz war.

Rückgabewert

NdisGetRssProcessorInformation kann einen der folgenden Statuswerte zurückgeben:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_BUFFER_TOO_SHORT
Die in Size Parameter angegebene Größe war zu klein. In diesem Fall stellt NDIS die erforderliche Puffergröße im parameter Size bereit.

Bemerkungen

NDIS-Treiber rufen die NdisGetRssProcessorInformation Funktion auf, um Informationen über die RSS-Prozessoren (Receive Side Scaling) auf dem lokalen Computer abzurufen.

RSS-fähige Miniporttreiber, die MSI-X Aufrufen von NdisGetRssProcessorInformation unterstützen MiniportFilterResourceRequirequirements Funktion. Miniport-Treiber legen die Unterbrechungsaffinität der zugeordneten MSI-X Nachrichten an die RSS-Prozessoren fest, die im RssProcessors Member des RssProcessorInfo Parameter angegeben sind.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.20 und höher.
Zielplattform- Universal
Header- ndis.h (include Ndis.h)
Library Ndis.lib
IRQL- <= DISPATCH_LEVEL

Siehe auch

MiniportFilterResourceRequirequirements

MiniportInitializeEx-

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx