struttura NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_NIC_SWITCH_VPORT_INFO specifica la configurazione per una porta virtuale (VPort) in un commutatore di scheda di rete della scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  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;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_NIC_SWITCH_VPORT_INFO . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare il membro Type di Header su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_NIC_SWITCH_VPORT_INFO , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1.

VPortId

Valore NDIS_NIC_SWITCH_VPORT_ID che identifica in modo univoco la porta virtuale (VPort) nella scheda di rete.

Il valore NDIS_DEFAULT_VPORT_ID specifica il VPort predefinito sull'opzione. Il VPort predefinito è sempre collegato alla funzione fisica PCI Express (PCIe) della scheda di rete.

Nota Un VPort non predefinito con il valore VPortId specificato deve essere stato creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

SwitchId

Valore NDIS_NIC_SWITCH_ID che identifica in modo univoco un commutatore di scheda di rete creato nella scheda di rete. Il VPort identificato tramite il membro VPortId viene creato sull'opzione specificata dal membro SwitchId .

L'identificatore del commutatore è un numero intero compreso tra zero e il numero di commutatori supportati dalla scheda di rete. Il valore NDIS_DEFAULT_SWITCH_ID indica il commutatore della scheda di rete predefinito.

Nota A partire da Windows Server 2012, l'interfaccia SR-IOV (Single Root I/O Virtualization) supporta solo il commutatore di scheda di rete predefinito nella scheda di rete. Il valore di questo membro deve essere impostato su NDIS_DEFAULT_SWITCH_ID.

VPortName

Valore NDIS_VPORT_NAME che specifica il nome del VPort creato nel commutatore di scheda di rete. Questo membro contiene la descrizione intuitiva del VPort.

AttachedFunctionId

Valore NDIS_SRIOV_FUNCTION_ID che specifica l'identificatore di un VF o del file PF a cui è collegato il VPort.

Nota Se questo valore è NDIS_PF_FUNCTION_ID, il VPort viene collegato al file PF.

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 da una coda di ricezione. Le coppie di code associate al VPort predefinito vengono configurate al momento della creazione del commutatore tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_SWITCH. Una o più coppie di code vengono configurate in un VPort non predefinito 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 degli interrupt del VPort.

VPortState

Valore NDIS_NIC_SWITCH_VPORT_STATE che specifica lo stato del VPort.

ProcessorAffinity

Valore GROUP_AFFINITY che specifica il numero di gruppo e una bitmap delle CPU a cui può essere associato questo VPort.

Questo membro è valido solo per i VPort collegati al file PF. Questo campo non è valido per le VPort non predefinite associate a un VF.

LookaheadSize

Questo membro è riservato per usi futuri. Questo membro deve essere impostato su zero.

NumFilters

Valore ULONG che specifica il numero di filtri di ricezione configurati nella scheda di rete.

Nota A partire da NDIS 6.30, il driver miniport deve mantenere un contatore per il numero corrente di filtri di ricezione impostati sulla scheda di rete. Il driver deve incrementare il contatore ogni volta che viene impostato un filtro di ricezione tramite una richiesta di set OID di OID_RECEIVE_FILTER_SET_FILTER. Il driver deve anche decrementare il contatore ogni volta che un filtro di ricezione viene cancellato tramite una richiesta di set OID di OID_RECEIVE_FILTER_CLEAR_FILTER.

Commenti

Una struttura NDIS_NIC_SWITCH_VPORT_INFO contiene informazioni su uno dei seguenti elementi:

Un VPort non predefinito creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
VPort predefinito collegato al file PF. Il VPort predefinito esiste sempre e non può essere eliminato.

Una o più strutture NDIS_NIC_SWITCH_VPORT_INFO vengono restituite tramite la struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

Per altre informazioni sull'interfaccia SR-IOV, vedere Panoramica di Single Root I/O Virtualization (SR-IOV).For more information about the SR-IOV interface, see Overview of Single Root I/O Virtualization (SR-IOV).