struttura NDIS_NIC_SWITCH_INFO (ntddndis.h)

Articolo
02/07/2025

La struttura NDIS_NIC_SWITCH_INFO specifica le informazioni relative a 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;

Membri

Header

Tipo, revisione e dimensione 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 di 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 dimensioni su NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

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

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

SwitchType

Valore NDIS_NIC_SWITCH_TYPE che specifica il tipo di opzione.

SwitchId

Valore NDIS_NIC_SWITCH_ID che specifica un identificatore switch. 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 di scheda di rete predefinito.

Nota A partire da Windows Server 2012, l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) 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 descrittiva dell'opzione.

NumVFs

Valore ULONG che specifica il numero di funzioni virtuali PCI Express (PCIe) 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 allocati nel commutatore della scheda di rete specificato da SwitchId. Le macchine virtuali vengono allocate tramite richieste di 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 è possibile creare tramite richieste di 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 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 pf della scheda di rete.

NumActiveNonDefaultVPortMacAddresses

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

NumActiveDefaultVPortVlanIds

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

NumActiveNonDefaultVPortVlanIds

Valore ULONG che specifica il numero di filtri di identificatore VLAN attualmente impostati nelle VPort non predefinite.

Osservazioni

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 in 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, vengono restituite solo le NDIS_NIC_SWITCH_INFO che descrivono le informazioni sul commutatore di scheda di rete predefinito 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 della virtualizzazione I/O radice singola (SR-IOV).