NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur (ntddndis.h)
Die NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur gibt die Konfiguration für einen virtuellen Port (VPort) auf einem Netzwerkadapterswitch des Netzwerkadapters an.
Syntax
typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_NIC_SWITCH_ID SwitchId;
NDIS_NIC_SWITCH_VPORT_ID VPortId;
NDIS_VPORT_NAME VPortName;
NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
ULONG NumQueuePairs;
NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
NDIS_NIC_SWITCH_VPORT_STATE VPortState;
GROUP_AFFINITY ProcessorAffinity;
ULONG LookaheadSize;
NDIS_NDK_PARAMETERS NdkParams;
NDIS_QOS_SQ_ID QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;
Member
Header
Typ, Revision und Größe der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.
Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen.
Um die Version der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur anzugeben, legen Sie den Revisionsmember von Header auf einen der folgenden Werte fest:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Das QosSqId-Feld für NDIS 6.50 wurde hinzugefügt.
Legen Sie das Element Größe auf NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2 fest.
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1
Originalversion für NDIS 6.30 und höher.
Legen Sie das Element Größe auf NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1 fest.
Flags
Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Die folgenden Flags sind für diesen Member definiert.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Dieses Flag ist für die zukünftige Verwendung reserviert. Miniporttreiber müssen dieses Flag ignorieren.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Dieses Flag gibt an, dass das Flags-Element aktualisiert wurde, nachdem der VPort erstellt wurde. Diese Flags können aktiviert oder deaktiviert werden, nachdem der VPort mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS erstellt wurde.
Hinweis
Dieses Flag ist nur gültig, wenn diese Struktur in OID-Satzanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS verwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
Dieses Flag gibt an, dass das VPortName-Element aktualisiert wurde, nachdem der VPort erstellt wurde. Dieser Member kann mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aktualisiert werden.
Hinweis
Dieses Flag ist nur gültig, wenn diese Struktur in OID-Satzanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS verwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Dieses Flag gibt an, dass das InterruptModeration-Element aktualisiert wurde, nachdem der VPort erstellt wurde. Dieser Member kann mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aktualisiert werden.
Hinweis
Dieses Flag ist nur gültig, wenn diese Struktur in OID-Satzanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS verwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Dieses Flag gibt an, dass der VPortState-Member aktualisiert wurde, nachdem der VPort erstellt wurde. Dieser Member kann mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aktualisiert werden.
Hinweis
Dieses Flag ist nur gültig, wenn diese Struktur in OID-Satzanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS verwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED
Dieses Flag gibt an, dass der ProcessoryAffinity-Member aktualisiert wurde, nachdem der VPort erstellt wurde. Die Prozessoraffinität eines VPorts kann nur aktualisiert werden, wenn der VPort an die PF auf dem Netzwerkadapter angefügt ist. Das ProcessoryAffinity-Element kann mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aktualisiert werden.
Hinweis
Dieses Flag ist nur gültig, wenn diese Struktur in OID-Satzanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS verwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED
Dieses Flag gibt an, dass das NumQueuePairs-Element aktualisiert wurde, nachdem der VPort erstellt wurde. Wenn VMMQ (Virtual Machine Multiple Queues) aktiviert ist, kann die Anzahl der Warteschlangen für standardbasierte und nicht standardmäßige Vports aktualisiert werden. Der NumQueuePairs-Member kann mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aktualisiert werden.
SwitchId
Ein NDIS_NIC_SWITCH_ID Wert, der den Bezeichner des Switches angibt, auf dem der VPort erstellt werden soll.
Der Switchbezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die vom Netzwerkadapter unterstützt werden. Ein NDIS_DEFAULT_SWITCH_ID-Wert gibt den Standard-Netzwerkadapterswitch an.
Hinweis
Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle (Single Root E/O Virtualization) nur den Standard-Netzwerkadapterswitch auf dem Netzwerkadapter. Der Wert dieses Members muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.
VPortId
Ein NDIS_NIC_SWITCH_VPORT_ID Wert, der den Bezeichner eines VPorts auf dem Netzwerkadapter angibt. Der Wert wird von NDIS zugeordnet und ist für den Netzwerkadapter eindeutig.
Der VPortId-Wert liegt innerhalb des Bereichs von null bis (NumVPorts - 1), wobei NumVPorts die Anzahl der VPorts darstellt, die der Miniporttreiber auf dem Netzwerkadapter konfiguriert hat. Der Treiber gibt diese Zahl im NumVPorts-Element der NDIS_NIC_SWITCH_INFO-Struktur an. Der Treiber gibt diese Struktur über eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHES zurück.
Hinweis
Ein VPort-Bezeichner von NDIS_DEFAULT_VPORT_ID ist für den Standard-VPort reserviert, der an die PF auf dem Standard-NIC-Switch angefügt ist.
VPortName
Ein NDIS_VPORT_NAME Wert, der den Namen des VPorts angibt. Dieses Element enthält eine benutzerfreundliche Beschreibung des VPorts.
AttachedFunctionId
Ein NDIS_SRIOV_FUNCTION_ID Wert, der die ID der physischen Funktion (PF) oder der virtuellen Funktion (VF) angibt, an die der VPort angefügt ist. Der Wert NDIS_PF_FUNCTION_ID gibt an, dass der VPort an die PF angefügt ist. Wenn der Wert ein gültiger VF-Bezeichner ist, wird der VPort an den VF angefügt.
NumQueuePairs
Ein ULONG-Wert, der die Anzahl der für diesen VPort konfigurierten Warteschlangenpaare angibt.
Ein Warteschlangenpaar besteht aus einer Übertragungs- und einer Empfangswarteschlange. Warteschlangenpaare, die dem Standard-VPort zugeordnet sind, werden zum Zeitpunkt der Switcherstellung über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH konfiguriert. Mindestens ein Warteschlangenpaar wird für einen nicht standardmäßigen VPort über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT konfiguriert.
InterruptModeration
Ein NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION Wert, der die Einstellung für die Unterbrechungsmoderation des VPorts angibt.
VPortState
Ein NDIS_NIC_SWITCH_VPORT_STATE Wert, der den aktuellen Zustand des VPorts angibt.
ProcessorAffinity
Ein GROUP_AFFINITY Wert, der die Gruppennummer und eine Bitmap der CPUs angibt, denen dieser VPort zugeordnet ist. Dieses Feld ist nur für VPorts gültig, die an die PF angefügt sind.
Hinweis
Bei nicht standardmäßigen PF-VPorts muss beim Erstellen des VPorts ein GROUP_AFFINITY Wert angegeben werden, der nur einen Prozessor angibt. VPorts werden über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT erstellt.
Die Prozessoraffinität, die dem nicht standardmäßigen VPort zugeordnet ist, der an die PF angefügt ist, kann nach der Erstellung des VPorts geändert werden. Die Prozessoraffinität, die dem Standard-VPort zugeordnet ist, kann auch mithilfe einer OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS geändert werden.
LookaheadSize
Dieses Element ist für die zukünftige Verwendung reserviert. Dieser Member muss auf 0 (null) festgelegt werden.
NdkParams
QosSqId
Ordnet einen vPort einer Scheduler-Warteschlange (SQ) zu. Legen Sie dieses Feld auf eine gültige SQ-ID fest, um den vPort einem SQ zuzuordnen. Legen Sie dieses Feld auf Null fest, wenn keine SQ-Zuordnung vorhanden ist. Weitere Informationen zu NDIS_QOS_SQ_ID finden Sie unter OID_QOS_OFFLOAD_CREATE_SQ.
Hinweise
Diese Struktur wird in OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_VPORT_PARAMETERS verwendet.
Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über single root E/O Virtualization (SR-IOV).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.30 und höher. |
| Unterstützte Mindestversion (Server) | Windows Server 2022 |
| Kopfzeile | ntddndis.h (include Ndis.h) |