NDIS_NIC_SWITCH_VPORT_PARAMETERS struttura (ntddndis.h)
La struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS specifica la configurazione per una porta virtuale (VPort) in un commutatore della scheda di rete.
Sintassi
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;
Members
Header
Tipo, revisione e dimensione della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .
Il driver miniport deve impostare il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT.
Per indicare la versione della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS , impostare il membro Revisionedell'intestazione su uno dei valori seguenti:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Aggiunto il campo QosSqId per NDIS 6.50.
Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2.
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1
Versione originale per NDIS 6.30 e versioni successive.
Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1.
Flags
Valore ULONG che contiene un OR bit per bit di flag. Per questo membro vengono definiti i flag seguenti.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Questo flag è riservato per l'uso futuro. I driver miniport devono ignorare questo flag.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Questo flag specifica che il membro Flags è stato aggiornato dopo la creazione del VPort. Questi flag possono essere abilitati o disabilitati dopo la creazione di VPort usando una richiesta OID set di OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Questo flag è valido solo quando questa struttura viene usata nelle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
Questo flag specifica che il membro VPortName è stato aggiornato dopo la creazione del VPort. Questo membro può essere aggiornato usando una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Questo flag è valido solo quando questa struttura viene usata nelle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Questo flag specifica che il membro InterruptModeration è stato aggiornato dopo la creazione del VPort. Questo membro può essere aggiornato usando una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Questo flag è valido solo quando questa struttura viene usata nelle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Questo flag specifica che il membro VPortState è stato aggiornato dopo la creazione del VPort. Questo membro può essere aggiornato usando una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Questo flag è valido solo quando questa struttura viene usata nelle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED
Questo flag specifica che il membro ProcessoryAffinity è stato aggiornato dopo la creazione del VPort. L'affinità del processore di un VPort può essere aggiornata solo se il VPort è collegato al pf nella scheda di rete. Il membro ProcessoryAffinity può essere aggiornato usando una richiesta OID set di OID_NIC_SWITCH_VPORT_PARAMETERS.
Nota
Questo flag è valido solo quando questa struttura viene usata nelle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED
Questo flag specifica che il membro NumQueuePairs è stato aggiornato dopo la creazione del VPort. Quando la macchina virtuale è abilitata per più code (VMMQ), è possibile aggiornare il numero di code per le Vport predefinite e non predefinite. Il membro NumQueuePairs può essere aggiornato usando una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
SwitchId
Valore NDIS_NIC_SWITCH_ID che specifica l'identificatore dell'interruttore in cui deve essere creato il VPort.
L'identificatore del commutatore è un intero compreso tra zero e il numero di commutatori supportati dalla scheda di rete. Un valore NDIS_DEFAULT_SWITCH_ID indica il commutatore della scheda di rete predefinito.
Nota
A partire da Windows Server 2012, l'interfaccia I/O (SR-IOV) singola supporta solo l'opzione scheda di rete predefinita nella scheda di rete. Il valore di questo membro deve essere impostato su NDIS_DEFAULT_SWITCH_ID.
VPortId
Valore NDIS_NIC_SWITCH_VPORT_ID che specifica l'identificatore di un VPort nella scheda di rete. Il valore viene allocato da NDIS ed è univoco nella scheda di rete.
Il valore VPortId si trova all'interno dell'intervallo compreso tra zero e (NumVPorts - 1), dove NumVPorts è il numero di VPorts configurati dal driver miniport nella scheda di rete. Il driver specifica questo numero nel membro NumVPorts della struttura NDIS_NIC_SWITCH_INFO . Il driver restituisce questa struttura tramite una richiesta di query OID di OID_NIC_SWITCH_ENUM_SWITCHES.
Nota
Un identificatore VPort di NDIS_DEFAULT_VPORT_ID è riservato per il VPort predefinito collegato al valore PF nell'opzione di interfaccia di interfaccia di rete predefinita.
VPortName
Valore NDIS_VPORT_NAME che specifica il nome del VPort. Questo membro contiene una descrizione descrittiva del VPort.
AttachedFunctionId
Valore NDIS_SRIOV_FUNCTION_ID che specifica l'ID della funzione fisica (PF) o della funzione virtuale a cui è associato il VPort. Un valore di NDIS_PF_FUNCTION_ID specifica che il VPort è collegato al pf. Se il valore è un identificatore VF valido, il VPort viene collegato al VF.
NumQueuePairs
Valore ULONG che specifica il numero di coppie di code configurate per questo VPort.
Una coppia di code è costituita da una coda di trasmissione e una coda di ricezione. Le coppie di code associate al VPort predefinito sono configurate al momento della creazione di un commutatore tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_SWITCH. Una o più coppie di code sono configurate in un VPort non definito tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
InterruptModeration
Valore NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION che specifica l'impostazione di moderazione dell'interruzione del VPort.
VPortState
Valore NDIS_NIC_SWITCH_VPORT_STATE che specifica lo stato corrente del VPort.
ProcessorAffinity
Valore GROUP_AFFINITY che specifica il numero di gruppo e una bitmap delle CPU associate a questa VPort. Questo campo è valido solo per I VPort collegati al pf.
Nota
Per VPort PF nondefault, è necessario specificare un valore GROUP_AFFINITY che specifica un solo processore quando viene creato il VPort. I VPort vengono creati tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
L'affinità del processore associata al VPort non definito al pf può essere modificata dopo la creazione di VPort. L'affinità del processore associata alla VPort predefinita può essere modificata anche usando una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Questo membro è riservato per usi futuri. Questo membro deve essere impostato su zero.
NdkParams
QosSqId
Associa un vPort a una coda dell'utilità di pianificazione (SQ). Impostare questo campo su un ID SQ valido per associare il vPort a un oggetto SQ. Impostare questo campo su zero se non esiste alcuna associazione SQ. Per altre informazioni su NDIS_QOS_SQ_ID, vedere OID_QOS_OFFLOAD_CREATE_SQ.
Commenti
Questa struttura viene usata nelle richieste OID di OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_VPORT_PARAMETERS.
Per altre informazioni sull'interfaccia SR-IOV, vedere Panoramica di Single Root I/O Virtualization (SR-IOV).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato in NDIS 6.30 e versioni successive. |
| Server minimo supportato | Windows Server 2022 |
| Intestazione | ntddndis.h (include Ndis.h) |