NDIS_NIC_SWITCH_VF_INFO_ARRAY struttura (ntddndis.h)

Articolo
02/26/2024

La struttura NDIS_NIC_SWITCH_VF_INFO_ARRAY specifica una matrice. Ogni elemento della matrice specifica gli attributi di funzioni virtuali PCI Express (PCIe) abilitate e allocate in una scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Members

Header

Tipo, revisione e dimensione della struttura NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY , NDIS imposta il membro Revision of Header sul valore seguente:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1.

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Se questo flag è impostato, il driver miniport deve restituire solo una matrice di strutture NDIS_NIC_SWITCH_VF_INFO per le macchine virtuali allocate nel commutatore della scheda di rete specificato dal membro SwitchId . Per altre informazioni, vedere la sezione Osservazioni.

Se il membro Flags è impostato su zero, il driver miniport deve restituire una matrice di strutture NDIS_NIC_SWITCH_VF_INFO per ogni VF allocato in ogni commutatore di scheda di rete della scheda di rete.

Nota A partire da Windows Server 2012, l'interfaccia SR-IOV supporta solo l'opzione scheda di rete predefinita nella scheda di rete. Pertanto, il driver miniport deve restituire solo una matrice di strutture NDIS_NIC_SWITCH_VF_INFO per ogni VF allocato nel commutatore della scheda di rete predefinito.

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.

Nota A partire da Windows Server 2012, l'interfaccia SR-IOV supporta solo il commutatore della scheda di rete predefinito creato nella scheda di rete. Pertanto, questo membro deve essere sempre impostato su NDIS_DEFAULT_SWITCH_ID.

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_VF_INFO_ARRAY fino all'inizio del primo elemento. Ogni elemento della matrice è una struttura NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY .

ElementSize

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

Commenti

NDIS restituisce una struttura NDIS_NIC_SWITCH_VF_INFO_ARRAY quando gestisce una richiesta di metodo OID di OID_NIC_SWITCH_ENUM_VFS. Ogni elemento nella matrice che segue la struttura NDIS_NIC_SWITCH_VF_INFO_ARRAY è un
NDIS_NIC_SWITCH_VF_INFO struttura.