NDIS_RSS_SET_INDIRECTION_ENTRY-Struktur (ntddndis.h)
Warnung
Einige Informationen in diesem Thema beziehen sich auf vorab freigegebene Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
RSSv2 ist nur in Windows 10 Version 1803 als Vorschauversion verfügbar.
Die NDIS_RSS_SET_INDIRECTION_ENTRY-Struktur stellt einen Befehl zum Festlegen eines einzelnen Indirektionstabelleneintrags dar. Es ist in einer NDIS_RSS_SET_INDIRECTION_ENTRIES-Struktur enthalten, die in der OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES OID verwendet wird. OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES ist eine synchrone OID für RSS Version 2 (RSSv2).
Syntax
typedef struct _NDIS_RSS_SET_INDIRECTION_ENTRY {
NDIS_NIC_SWITCH_ID SwitchId;
NDIS_NIC_SWITCH_VPORT_ID VPortId;
ULONG Flags;
USHORT IndirectionTableIndex;
PROCESSOR_NUMBER TargetProcessorNumber;
NDIS_STATUS EntryStatus;
} NDIS_RSS_SET_INDIRECTION_ENTRY, *PNDIS_RSS_SET_INDIRECTION_ENTRY;
Member
SwitchId
Ein NDIS_NIC_SWITCH_ID Wert, der den NIC-Switch darstellt, in dem sich der VPort befindet.
Der Switch-Bezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die der Netzwerkadapter unterstützt. Ein NDIS_DEFAULT_SWITCH_ID-Wert gibt den Standard-Netzwerkadapterswitch an.
Dieses Feld sollte im Fall nativer RSS auf 0 festgelegt werden.
VPortId
Ein NDIS_NIC_SWITCH_VPORT_ID Wert, der den VPort-Bezeichner darstellt.
Dieses Feld sollte im Fall nativer RSS auf 0 festgelegt werden.
Flags
Ein ULONG-Wert , der ein bitweises OR von Flags enthält. Dieses Element qualifiziert die Informationen in dieser Struktur.
Mögliche Flags sind wie folgt:
IndirectionTableIndex
Der Hashindex des ITE, der derzeit auf die aktuelle CPU zeigt und so geändert wird, dass er auf einen anderen Prozessor verweist. Wenn die Indirektionstabelle inaktiv ist (RSS ist deaktiviert), sollte der Miniporttreiber Updates für Indirektionstabelleneinträge nachverfolgen, damit er die richtige Indirektionstabelle aufweist, wenn RSS aktiviert ist.
TargetProcessorNumber
Die Zielprozessornummer, auf die die ITE nach Abschluss verweisen soll. Der Miniporttreiber sollte erfolgreich sein, dass ITE vom aktuellen zum aktuellen Prozessor wechselt.
EntryStatus
Ein NDIS_STATUS Code, der die status des Verschiebungsvorgangs für diesen Eintrag angibt. Da NDIS_RSS_SET_INDIRECTION_ENTRY im Kontext eines synchronen OID-Aufrufs verwendet wird, kann der Miniporttreiber keine NDIS_STATUS_PENDING für dieses Element zurückgeben.
Um die Implementierung von Miniporttreibern zu vereinfachen, initialisiert das Protokoll der oberen Ebene dieses Feld für NDIS_STATUS_PENDING. Miniporttreiber müssen NDIS_STATUS_PENDING entweder mit einem erfolgreichen oder fehlerhaften NDIS-status-Code überschreiben. Wenn die obere Ebene erkennt, dass dieses Feld nach Abschluss der OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES OID noch NDIS_STATUS_PENDING ist, führt dies zu einer Systemfehlerüberprüfung und gibt an, dass der Miniporttreiber einen Fehler aufweist.
Wichtig
Alle NDIS_RSS_SET_INDIRECTION_ENTRY Strukturen in einer Gruppe, die in einer NDIS_RSS_SET_INDIRECTION_ENTRIES-Struktur enthalten sind, müssen mit demselben EntryStatus gekennzeichnet werden.
Wenn mit diesem Verschiebungsbefehl ein Fehler auftritt, legen Sie EntryStatus auf einen der folgenden status Codes für diese Fehlerbedingung fest:
Statuscode | Fehlerzustand |
---|---|
NDIS_STATUS_INVALID_PARAMETER |
|
NDIS_STATUS_INVALID_PORT_STATE | Der VPort ist nicht aktiviert oder befindet sich in einem anderen Zustand, der verhindert, dass er RSSv2-OIDs akzeptiert. |
NDIS_STATUS_NOT_ACCEPTED | Die Actor-CPU war ungültig. |
NDIS_STATUS_INVALID_DATA | Bei einem aktiven Lenkparameter ist der neue Prozessor nicht Teil des RSS-Prozessorsatzes des Adapters. Beachten Sie, dass inaktive Parameter nur nachverfolgt werden müssen. Sie werden später überprüft, während des RSS-Statusübergangs (ein oderaus). |
NDIS_STATUS_NO_QUEUES | Eine Gruppe von Befehlseinträgen schlägt die Überprüfung der "Anzahl von Warteschlangen" für den von dieser Gruppe angegebenen VPort fehl. |
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.80 und höher. |
Kopfzeile | ntddndis.h (include Ndis.h) |
Weitere Informationen
NDIS_RSS_SET_INDIRECTION_ENTRIES
OID_GEN_RSS_SET_INDIRECTION_TABLE_ENTRIES