NdisGetRssProcessorInformation-Funktion (ndis.h)

Artikel
02/29/2024

Die NdisGetRssProcessorInformation-Funktion ruft Informationen zu den 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-instance Handle, das während der Aufruferinitialisierung 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 gibt die Länge des Puffers im Parameter Size an.

[in, out] Size

Ein Zeiger auf einen Wert, der die Größe des vom Aufrufer bereitgestellten Puffers in Bytes entspricht. Wenn die Funktion zurückgibt, enthält dieses Element entweder die Menge an Daten, die NDIS in den Puffer eingefügt hat, oder die erforderliche Größe des Puffers, wenn der Puffer zu kurz war.

Rückgabewert

NdisGetRssProcessorInformation kann einen der folgenden status-Werte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_BUFFER_TOO_SHORT	Die größe, die im Parameter Size angegeben wurde, war zu klein. In diesem Fall stellt NDIS die erforderliche Puffergröße im Size-Parameter bereit.

Hinweise

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 unterstützen, rufen NdisGetRssProcessorInformation in ihren MiniportFilterResourceRequirements-Funktion . Miniporttreiber legen die Interruptaffinität der zugeordneten MSI-X-Nachrichten für die RSS-Prozessoren fest, die im RssProcessors-Member des RssProcessorInfo-Parameters angegeben sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.20 und höher.
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

MiniportFilterResourceRequirerements