struttura NDIS_NIC_SWITCH_INFO (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_NIC_SWITCH_INFO specifica le informazioni su un commutatore di scheda di rete in una scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_NIC_SWITCH_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_INFO , il driver deve impostare il membro Revision di Header sul valore seguente:

NDIS_NIC_SWITCH_INFO_REVISION_1

Versione originale per NDIS 6.30.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit dei flag di configurazione abilitati per l'opzione.

Nota Per NDIS 6.30, non sono definiti flag di configurazione per l'opzione. Il membro Flags deve essere impostato su zero.

SwitchType

Valore NDIS_NIC_SWITCH_TYPE che specifica il tipo dell'opzione.

SwitchId

Valore NDIS_NIC_SWITCH_ID che specifica un identificatore di opzione. L'identificatore del commutatore è un numero 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 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.

SwitchFriendlyName

Valore NDIS_NIC_SWITCH_FRIENDLYNAME che contiene la descrizione intuitiva dell'opzione.

NumVFs

Valore ULONG che specifica il numero di funzioni virtuali (PCIe) PCI Express abilitate nella scheda di rete. Le macchine virtuali abilitate possono trovarsi in uno stato allocato o non allocato.

NumAllocatedVFs

Valore ULONG che specifica il numero di VFS allocate nel commutatore della scheda di rete specificato da SwitchId. Le macchine virtuali vengono allocate tramite richieste set OID di OID_NIC_SWITCH_ALLOCATE_VF.

NumVPorts

Valore ULONG che specifica il numero di porte virtuali (VPort) configurate nel commutatore della scheda di rete specificato da SwitchId.

Questo valore di ULONG è la somma dei seguenti:

Numero massimo di VPort che possono essere creati tramite richieste set OID di OID_NIC_SWITCH_CREATE_VPORT.
VPort predefinito collegato alla funzione fisica (PF).

NumActiveVPorts

Valore ULONG che specifica il numero di VPort creati nel commutatore della scheda di rete specificato da SwitchId.

Nota Questo valore di ULONG include il VPort predefinito, oltre alle VPort non predefinite create tramite richieste di set OID di OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

Valore ULONG che specifica il numero di coppie di code allocate per il VPort predefinito. Il VPort predefinito è sempre collegato al file PF.

Una coppia di code è costituita da una coda di trasmissione e da una coda di ricezione. Il driver miniport associa una o più coppie di code al VPort predefinito al momento della creazione del commutatore tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_SWITCH.

Nota A partire da NDIS 6.30, è possibile configurare una sola coppia di code per il VPort predefinito.

NumQueuePairsForNonDefaultVPorts

Valore ULONG che specifica il numero di coppie di code allocate per le porte virtuali non predefinite. Un VPort non predefinito può essere collegato al file PF o a qualsiasi VF della scheda di rete.

Il driver miniport associa una o più coppie di code a un VPort non predefinito tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Valore ULONG che specifica il numero di filtri di indirizzi MAC unicast attualmente impostati sul VPort predefinito collegato al file PF della scheda di rete.

NumActiveNonDefaultVPortMacAddresses

Valore ULONG che specifica il numero di filtri di indirizzi MAC unicast attualmente impostati in VPort non predefiniti.

NumActiveDefaultVPortVlanIds

Valore ULONG che specifica il numero di filtri identificatori VLAN (Virtual Local Area Network) attualmente impostati sul VPort predefinito.

NumActiveNonDefaultVPortVlanIds

Valore ULONG che specifica il numero di filtri identificatore VLAN attualmente impostati nei VPort non predefiniti.

Commenti

La struttura NDIS_NIC_SWITCH_INFO viene usata nelle richieste di query OID di OID_NIC_SWITCH_ENUM_SWITCHES. Questa richiesta OID viene usata per enumerare i commutatori della scheda di rete su una scheda di rete. Quando viene eseguita questa richiesta OID, una o più strutture NDIS_NIC_SWITCH_INFO vengono restituite all'interno di una struttura NDIS_NIC_SWITCH_INFO_ARRAY .

Nota A partire da NDIS 6.30, solo il NDIS_NIC_SWITCH_INFO che descrive le informazioni sul commutatore di scheda di rete predefinito viene restituito tramite una richiesta OID di OID_NIC_SWITCH_ENUM_SWITCHES.

Una struttura NDIS_NIC_SWITCH_INFO contiene informazioni su un commutatore di scheda di rete creato in precedenza tramite una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_SWITCH.

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).