struttura NDIS_NIC_SWITCH_PARAMETERS (ntddndis.h)

Articolo
02/27/2024

La struttura NDIS_NIC_SWITCH_PARAMETERS specifica i parametri di configurazione di un commutatore di scheda di rete nella scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Members

Header

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_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_PARAMETERS_SWITCH_NAME_CHANGED

Questo flag specifica che il campo aggiornato nella struttura NDIS_NIC_SWITCH_PARAMETERS è il membro SwitchName .

Nota Questo flag è valido solo quando questa struttura viene usata in una richiesta di set OID di OID_NIC_SWITCH_PARAMETERS.

SwitchType

Valore di enumerazione NDIS_NIC_SWITCH_TYPE che specifica il tipo di commutatore della scheda di rete.

Nota A partire da Windows Server 2012, Windows supporta solo un tipo di opzione NdisNicSwitchTypeExternal. Un commutatore esterno specifica che le porte connesse a questo tipo di commutatore possono accedere alla rete esterna tramite la porta fisica nella scheda di rete. La porta virtuale predefinita (VPort) nel commutatore esterno fornisce connettività di rete esterna allo stack di virtualizzazione eseguito nel sistema operativo di gestione della partizione padre Hyper-V.

SwitchId

Valore NDIS_NIC_SWITCH_ID che contiene 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 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 una descrizione per l'opzione.

NumVFs

Valore ULONG che specifica il numero di funzioni virtuali (PCIe) PCI Express abilitate nella scheda di rete. Le macchine virtuali sono abilitate nella scheda quando la virtualizzazione è abilitata tramite una chiamata a NdisMEnableVirtualization.

Nota Prima che un VF possa essere collegato a una partizione figlio Hyper-V, è necessario allocare le risorse tramite una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.

NdisReserved1

Riservato per NDIS.

NdisReserved2

Riservato per NDIS.

NdisReserved3

Riservato per NDIS.

NumQueuePairsForDefaultVPort

Commenti

La struttura NDIS_NIC_SWITCH_PARAMETERS viene usata nelle richieste del metodo OID di OID_NIC_SWITCH_CREATE_SWITCH e OID_NIC_SWITCH_PARAMETERS. Queste richieste OID impostano o eseguono query sui parametri di configurazione di un commutatore di scheda di rete.

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