struttura NDIS_SWITCH_NIC_ARRAY (ntddndis.h)

Articolo
08/07/2023

La struttura NDIS_SWITCH_NIC_ARRAY specifica una matrice di parametri di configurazione della scheda di rete. Ogni elemento nella matrice specifica i parametri per una scheda di rete connessa a una porta su un commutatore estendibile Hyper-V. Ogni elemento viene formattato come struttura NDIS_SWITCH_NIC_PARAMETERS .

Sintassi

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

Members

Header

Tipo, revisione e dimensioni della struttura NDIS_SWITCH_NIC_ARRAY . Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il membro Type di Header deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT. Per specificare la versione della struttura NDIS_SWITCH_NIC_ARRAY , il membro Revisiondell'intestazione deve essere impostato sul valore seguente:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Versione originale per NDIS 6.30 e versioni successive.

Impostare il membro Size su NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

Valore ULONG che contiene un OR bit per bit di flag. Questo membro è riservato per NDIS.

FirstElementOffset

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

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

NumElements

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

ElementSize

Valore ULONG che specifica le dimensioni, in byte, degli elementi NDIS_SWITCH_NIC_PARAMETERS che seguono la struttura NDIS_SWITCH_NIC_ARRAY .

Commenti

La struttura NDIS_SWITCH_NIC_ARRAY viene restituita nelle richieste di query OID di OID_SWITCH_NIC_ARRAY. Una matrice di strutture NDIS_SWITCH_NIC_PARAMETERS segue la struttura NDIS_SWITCH_NIC_ARRAY nel buffer delle informazioni associato alla richiesta di query OID. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a questo buffer di informazioni.

Le estensioni del commutatore estendibile possono accedere a singole strutture NDIS_SWITCH_NIC_PARAMETERS all'interno di una struttura NDIS_SWITCH_NIC_ARRAY usando la macro NDIS_SWITCH_NIC_AT_ARRAY_INDEX .