NDIS_NIC_SWITCH_INFO_ARRAY structure (ntddndis.h)
The NDIS_NIC_SWITCH_INFO_ARRAY structure specifies an array. Each element in the array specifies the attributes of a network adapter switch that has been created on the network adapter.
Syntax
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
The type, revision, and size of the NDIS_NIC_SWITCH_INFO_ARRAY structure. This member is formatted as an NDIS_OBJECT_HEADER structure.
NDIS sets the Type member of Header to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_NIC_SWITCH_INFO_ARRAY structure, NDIS sets the Revision member of Header to the following value:
NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1
Original version for NDIS 6.30.
Set the Size member to NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1.
FirstElementOffset
A ULONG 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_NIC_SWITCH_INFO_ARRAY structure up to the beginning of the first element. Each element in the array is an NDIS_NIC_SWITCH_INFO structure.
NumElements
A ULONG value that specifies the number of elements that follow the NDIS_NIC_SWITCH_INFO_ARRAY structure.
ElementSize
A ULONG value that specifies the size, in bytes, of each element that follows the NDIS_NIC_SWITCH_INFO_ARRAY structure.
Remarks
NDIS returns an NDIS_NIC_SWITCH_INFO_ARRAY structure in the following ways:
- When NDIS handles an OID query request of OID_NIC_SWITCH_ENUM_SWITCHES, it returns a pointer to an NDIS_NIC_SWITCH_INFO_ARRAY structure in the InformationBuffer member of the NDIS_OID_REQUEST.
- When NDIS calls the ProtocolBindAdapterEx function, NDIS passes a pointer to an NDIS_BIND_PARAMETERS structure in the BindParameters parameter. NDIS sets the NicSwitchArray member of the NDIS_BIND_PARAMETERS structure to a pointer to an NDIS_NIC_SWITCH_INFO_ARRAY structure.
- When NDIS calls the FilterAttach function, NDIS passes a pointer to an NDIS_FILTER_ATTACH_PARAMETERS structure in the AttachParameters parameter. NDIS sets the NicSwitchArray member of the NDIS_FILTER_ATTACH_PARAMETERS structure to a pointer to an NDIS_NIC_SWITCH_INFO_ARRAY structure.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Supported in NDIS 6.30 and later. |
Header | ntddndis.h (include Ndis.h) |
See also