NDIS_NIC_SWITCH_VPORT_INFO_ARRAY struttura (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY specifica una matrice. Ogni elemento della matrice specifica gli attributi di una porta virtuale (VPort) creata nel commutatore della scheda di rete di una scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

NDIS imposta il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , NDIS imposta il membro Revisionedell'intestazione sul valore seguente:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit dei flag seguenti:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Questo flag specifica per enumerare i VPort collegati a una funzione PCI Express (PCIe) specifica. La funzione viene specificata nel membro AttachedFunctionId . Questo flag può essere usato per enumerare le VPort collegate alla funzione fisica PCIe (PF) o a una funzione virtuale PCIe specificata (VF).

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Questo flag specifica per enumerare le VPort create in un commutatore specifico, specificato da SwitchId. In questo modo vengono enumerate tutte le VPort create sull'opzione.

Nota Questi flag si escludono a vicenda. È possibile impostare un solo flag nel membro Flags .

SwitchId

Valore NDIS_NIC_SWITCH_ID che specifica un identificatore di commutatore. 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.

Il membro SwitchId è valido solo se NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH è specificato nel membro Flags .

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.

AttachedFunctionId

Valore NDIS_SRIOV_FUNCTION_ID che specifica l'identificatore del pf o di un VF nella scheda di rete.

Nota Se questo valore è NDIS_PF_FUNCTION_ID, il VPort è collegato al pf.

Il membro AttachedFunctionId è valido solo se NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION è specificato nel membro Flags .

FirstElementOffset

Valore ULONG che specifica l'offset, in byte, al primo elemento in una matrice di elementi che seguono questa struttura. L'offset viene misurato dall'inizio della struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY fino all'inizio del primo elemento. Ogni elemento della matrice è una struttura NDIS_NIC_SWITCH_VPORT_INFO .

Nota Se NumElements è impostato su zero, questo membro viene ignorato.

NumElements

Valore ULONG che specifica il numero di elementi che seguono la struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY.

ElementSize

Valore ULONG che specifica le dimensioni, in byte, di ogni elemento che segue la struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

Commenti

NDIS restituisce una struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY quando NDIS gestisce una richiesta di metodo OID di OID_NIC_SWITCH_ENUM_VPORTS. Ogni elemento della matrice che segue la struttura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY è un
NDIS_NIC_SWITCH_VPORT_INFO struttura.

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.
Intestazione	ntddndis.h (include Ndis.h)

Vedi anche

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

Condividi tramite