NDIS_SWITCH_NIC_ARRAY structure (ntddndis.h)

The NDIS_SWITCH_NIC_ARRAY structure specifies an array of network adapter configuration parameters. Each element in the array specifies the parameters for a network adapter that is connected to a port on a Hyper-V extensible switch. Each element is formatted as an NDIS_SWITCH_NIC_PARAMETERS structure.

Syntax

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

The type, revision, and size of the NDIS_SWITCH_NIC_ARRAY structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The Type member of Header must be set to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_SWITCH_NIC_ARRAY structure, the Revision member of Header must be set to the following value:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Original version for NDIS 6.30 and later.

Set the Size member to NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1.

Flags

A ULONG value that contains a bitwise OR of flags. This member is reserved for NDIS.

FirstElementOffset

A USHORT value that specifies the offset, in bytes, to the first element in an array of elements that follow this structure. The offset is measured from the start of the NDIS_SWITCH_NIC_ARRAY structure up to the beginning of the first element. Each element in the array is an NDIS_SWITCH_NIC_PARAMETERS structure.

NumElements

A ULONG value that specifies the number of NDIS_SWITCH_NIC_PARAMETERS elements that follow the NDIS_SWITCH_NIC_ARRAY structure.

ElementSize

A ULONG value that specifies the size, in bytes, of the NDIS_SWITCH_NIC_PARAMETERS elements that follows the NDIS_SWITCH_NIC_ARRAY structure.

Remarks

The NDIS_SWITCH_NIC_ARRAY structure is returned in OID query requests of OID_SWITCH_NIC_ARRAY. An array of NDIS_SWITCH_NIC_PARAMETERS structures follows the NDIS_SWITCH_NIC_ARRAY structure in the information buffer that is associated with the OID query request. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to this information buffer.

Extensible switch extensions can access individual NDIS_SWITCH_NIC_PARAMETERS structures inside an NDIS_SWITCH_NIC_ARRAY structure by using the NDIS_SWITCH_NIC_AT_ARRAY_INDEX macro.

Requirements

See also

NDIS_OBJECT_HEADER

NDIS_SWITCH_NIC_AT_ARRAY_INDEX

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_ARRAY