NDIS_NIC_SWITCH_INFO_ARRAY 結構 (ntddndis.h)

發行項
02/29/2024

NDIS_NIC_SWITCH_INFO_ARRAY 結構會指定陣列。數位中的每個元素都會指定網路適配器交換器的屬性，該交換器已在網路配接器上建立。

語法

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;

成員

Header

NDIS_NIC_SWITCH_INFO_ARRAY 結構的型別、修訂和大小。這個成員會格式化為 NDIS_OBJECT_HEADER 結構。

NDIS 會將 Header 的 Type 成員設定為 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_NIC_SWITCH_INFO_ARRAY結構的版本，NDIS 會將 Header 的 Revision 成員設定為下列值：

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

NDIS 6.30 的原始版本。

將 Size 成員設定為 NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1。

FirstElementOffset

ULONG 值，指定此結構後面元素陣列中第一個專案的位移，以位元組為單位。位移是從 NDIS_NIC_SWITCH_INFO_ARRAY 結構的開頭到第一個專案的開頭來測量。陣列中的每個元素都是 NDIS_NIC_SWITCH_INFO 結構。

注意如果 NumElements 設定為零，則會忽略此成員。

NumElements

ULONG 值，指定 NDIS_NIC_SWITCH_INFO_ARRAY 結構之後的項目數目。

ElementSize

ULONG 值，指定 NDIS_NIC_SWITCH_INFO_ARRAY結構之後 每個元素的大小，以位元組為單位。

備註

NDIS 會以下列方式傳回 NDIS_NIC_SWITCH_INFO_ARRAY 結構：

當 NDIS 處理OID_NIC_SWITCH_ENUM_SWITCHES的 OID 查詢要求時，它會傳回NDIS_OID_REQUESTInformationBuffer 成員中NDIS_NIC_SWITCH_INFO_ARRAY結構的指標。
當 NDIS 呼叫 ProtocolBindAdapterEx 函式時，NDIS 會將指標傳遞至 BindParameters 參數中的NDIS_BIND_PARAMETERS結構。 NDIS 會將NDIS_BIND_PARAMETERS結構的 NicSwitchArray 成員設定為NDIS_NIC_SWITCH_INFO_ARRAY結構的指標。
當 NDIS 呼叫 FilterAttach 函式時，NDIS 會將指標傳遞給 AttachParameters 參數中的NDIS_FILTER_ATTACH_PARAMETERS結構。 NDIS 會將NDIS_FILTER_ATTACH_PARAMETERS結構的 NicSwitchArray 成員設定為NDIS_NIC_SWITCH_INFO_ARRAY結構的指標。