NDIS_NIC_SWITCH_INFO_ARRAY struttura (ntddndis.h)

Articolo
02/27/2024

La struttura NDIS_NIC_SWITCH_INFO_ARRAY specifica una matrice. Ogni elemento della matrice specifica gli attributi di un commutatore della scheda di rete creato nella scheda di rete.

Sintassi

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Members

Header

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

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Versione originale per NDIS 6.30.

Impostare il membro Size su NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.

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

ElementSize

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

Commenti

NDIS restituisce una struttura NDIS_NIC_SWITCH_INFO_ARRAY nei modi seguenti:

Quando NDIS gestisce una richiesta di query OID di OID_NIC_SWITCH_ENUM_SWITCHES, restituisce un puntatore a una struttura NDIS_NIC_SWITCH_INFO_ARRAY nel membro InformationBufferdelNDIS_OID_REQUEST.
Quando NDIS chiama la funzione ProtocolBindAdapterEx , NDIS passa un puntatore a una struttura NDIS_BIND_PARAMETERS nel parametro BindParameters . NDIS imposta il membro NicSwitchArray della struttura NDIS_BIND_PARAMETERS su un puntatore a una struttura NDIS_NIC_SWITCH_INFO_ARRAY .
Quando NDIS chiama la funzione FilterAttach , NDIS passa un puntatore a una struttura NDIS_FILTER_ATTACH_PARAMETERS nel parametro AttachParameters . NDIS imposta il membro NicSwitchArray della struttura NDIS_FILTER_ATTACH_PARAMETERS su un puntatore a una struttura NDIS_NIC_SWITCH_INFO_ARRAY .

Ogni elemento della matrice che segue la struttura NDIS_NIC_SWITCH_INFO_ARRAY è una struttura NDIS_NIC_SWITCH_INFO .

Nota A partire da NDIS 6.30, viene restituita solo la NDIS_NIC_SWITCH_INFO che descrive le informazioni sul commutatore della scheda di rete predefinito tramite una richiesta di query OID di OID_NIC_SWITCH_ENUM_SWITCHES.