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;
Angehörige
Header
Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_VPORT_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.
Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen.
Um die Version der NDIS_NIC_SWITCH_VPORT_PARAMETERS Struktur anzugeben, legen Sie das Revision Member 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 Size Member 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 den Size Member 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 werden für dieses Element definiert.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Diese Kennzeichnung 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 Member aktualisiert wurde, nachdem der VPort erstellt wurde. Diese Flags können aktiviert oder deaktiviert werden, nachdem der VPort mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSerstellt wurde.
Anmerkung
Dieses Kennzeichen ist nur gültig, wenn diese Struktur in OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERSverwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
Dieses Flag gibt an, dass das VPortName Member aktualisiert wurde, nachdem der VPort erstellt wurde. Dieses Element kann mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSaktualisiert werden.
Anmerkung
Dieses Kennzeichen ist nur gültig, wenn diese Struktur in OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERSverwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Dieses Flag gibt an, dass das InterruptModeration Member aktualisiert wurde, nachdem der VPort erstellt wurde. Dieses Element kann mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSaktualisiert werden.
Anmerkung
Dieses Kennzeichen ist nur gültig, wenn diese Struktur in OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERSverwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Dieses Flag gibt an, dass das VPortState Member aktualisiert wurde, nachdem der VPort erstellt wurde. Dieses Element kann mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSaktualisiert werden.
Anmerkung
Dieses Kennzeichen ist nur gültig, wenn diese Struktur in OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERSverwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED
Dieses Flag gibt an, dass das ProcessoryAffinity Member aktualisiert wurde, nachdem der VPort erstellt wurde. Die Prozessoraffinität eines VPorts kann nur aktualisiert werden, wenn der VPort an den PF auf dem Netzwerkadapter angeschlossen ist. Das ProcessoryAffinity Member kann mithilfe einer OID-Setanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSaktualisiert werden.
Anmerkung
Dieses Kennzeichen ist nur gültig, wenn diese Struktur in OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERSverwendet wird.
NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED
Dieses Flag gibt an, dass das NumQueuePairs- Mitglied aktualisiert wurde, nachdem der VPort erstellt wurde. Wenn vm Multiple Queues (VMMQ) aktiviert ist, können die Anzahl der Warteschlangen für Standard- und nicht standardmäßige Vports aktualisiert werden. Das NumQueuePairs Member kann mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSaktualisiert werden.
SwitchId
Ein NDIS_NIC_SWITCH_ID Wert, der den Bezeichner des Schalters angibt, auf dem der VPort erstellt werden soll.
Der Switchbezeichner ist eine ganze Zahl zwischen Null und der Anzahl der Switches, die der Netzwerkadapter unterstützt. Ein NDIS_DEFAULT_SWITCH_ID Wert gibt den Standard-Netzwerkadapter-Switch an.
Anmerkung
Ab Windows Server 2012 unterstützt die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) nur den Standard-Netzwerkadapter-Switch auf dem Netzwerkadapter. Der Wert dieses Elements 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 zugewiesen und ist über den Netzwerkadapter eindeutig.
Der wert VPortId liegt innerhalb des Bereichs von Null bis (NumVPorts - 1), wobei NumVPorts- die Anzahl der VPorts ist, die der Miniporttreiber auf dem Netzwerkadapter konfiguriert hat. Der Treiber gibt diese Zahl im NumVPorts Member der NDIS_NIC_SWITCH_INFO Struktur an. Der Treiber gibt diese Struktur über eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHESzurück.
Anmerkung
Ein VPort-Bezeichner von NDIS_DEFAULT_VPORT_ID ist für den Standard-VPort reserviert, der an den PF auf dem Standard-NIC-Switch angefügt ist.
VPortName
Ein NDIS_VPORT_NAME Wert, der den Namen des VPort angibt. Dieses Mitglied enthält eine benutzerfreundliche Beschreibung des VPort.
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. Ein Wert von 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 Warteschlangenpaare angibt, die für diesen VPort konfiguriert sind.
Ein Warteschlangenpaar besteht aus einer Übertragungswarteschlange und einer Empfangswarteschlange. Warteschlangenpaare, die dem Standard-VPort zugeordnet sind, werden zum Zeitpunkt der Switcherstellung über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCHkonfiguriert. Mindestens ein Warteschlangenpaar wird für einen nicht standardmäßigen VPort über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTkonfiguriert.
InterruptModeration
Ein NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION Wert, der die Unterbrechungsmoderationseinstellung des VPort angibt.
VPortState
Ein NDIS_NIC_SWITCH_VPORT_STATE Wert, der den aktuellen Status des VPort 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.
Anmerkung
Bei nicht standardmäßigen PF-VPorts muss ein GROUP_AFFINITY Wert, der nur einen Prozessor angibt, angegeben werden, wenn der VPort erstellt wird. VPorts werden über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTerstellt.
Die Prozessoraffinität, die dem nicht standardmäßigen VPort zugeordnet ist, der an die PF angefügt ist, kann nach der VPort-Erstellung geändert werden. Die Prozessoraffinität, die dem Standard-VPort zugeordnet ist, kann auch mithilfe einer OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERSgeändert werden.
LookaheadSize
Dieses Mitglied ist für die zukünftige Verwendung reserviert. Dieses Element muss auf 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_IDfinden Sie unter OID_QOS_OFFLOAD_CREATE_SQ.
Bemerkungen
Diese Struktur wird in OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_VPORT_PARAMETERSverwendet.
Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über die Single Root I/O Virtualization (SR-IOV).
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.30 und höher. |
| mindestens unterstützte Server- | Windows Server 2022 |
| Header- | ntddndis.h (include Ndis.h) |