NdisGetRssProcessorInformation-Funktion (ndis.h)
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:
[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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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 |