Condividi tramite


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.

Nota Questo flag è valido solo quando questa struttura viene usata nelle richieste del 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)

Vedi anche

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_SWITCHES

OID_NIC_SWITCH_VPORT_PARAMETERS