NDIS_NIC_SWITCH_INFO_ARRAY 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

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 は、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定 します 。 NDIS_NIC_SWITCH_INFO_ARRAY構造体のバージョンを指定するために、NDIS は Header の Revision メンバーを次の値に設定します。

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

NDIS 6.30 の元のバージョン。

[サイズ] メンバーをNDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1に設定します。

FirstElementOffset

この構造体に続く要素の配列内の最初の要素へのオフセットをバイト単位で指定する ULONG 値。オフセットは、 NDIS_NIC_SWITCH_INFO_ARRAY 構造体の先頭から最初の要素の先頭まで測定されます。配列内の各要素は、NDIS_NIC_SWITCH_INFO 構造体です。

メモNumElements が 0 に設定されている場合、このメンバーは無視されます。

NumElements

NDIS_NIC_SWITCH_INFO_ARRAY構造体に続く要素の数を指定する ULONG 値。

ElementSize

NDIS_NIC_SWITCH_INFO_ARRAY構造体に続く各要素のサイズをバイト単位で指定する ULONG 値。

注釈

NDIS は、次の方法で NDIS_NIC_SWITCH_INFO_ARRAY 構造体を返します。

NDIS は、OID_NIC_SWITCH_ENUM_SWITCHESの OID クエリ要求を処理すると、NDIS_OID_REQUESTの InformationBuffer メンバー内の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構造体へのポインターに設定します。