NDIS_NIC_SWITCH_VF_INFO_ARRAY 構造体 (ntddndis.h)

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体は配列を指定します。配列内の各要素は、ネットワークアダプターで有効にされ、割り当てられた PCI Express (PCIe) 仮想関数 (VF) の属性を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

メンバー

Header

NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

NDIS は、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定 します 。 NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体のバージョンを指定するために、NDIS は Header の Revision メンバーを次の値に設定します。

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

NDIS 6.30 以降の元のバージョン。

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

Flags

次のフラグのビットごとの OR を含む ULONG 値。

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

このフラグが設定されている場合、ミニポートドライバーは、SwitchId メンバーによって指定されたネットワークアダプタースイッチに割り当てられている VM のNDIS_NIC_SWITCH_VF_INFO構造体の配列のみを返す必要があります。詳細については、「解説」を参照してください。

Flags メンバーが 0 に設定されている場合、ミニポートドライバーは、ネットワークアダプターのすべてのネットワークアダプタースイッチに割り当てられているすべての VF の NDIS_NIC_SWITCH_VF_INFO 構造体の配列を返す必要があります。

メモWindows Server 2012以降、SR-IOV インターフェイスでは、ネットワークアダプターの既定のネットワークアダプタースイッチのみがサポートされます。したがって、ミニポートドライバーは、既定のネットワークアダプタースイッチに割り当てられている各 VF の NDIS_NIC_SWITCH_VF_INFO 構造体の配列のみを返す必要があります。

SwitchId

スイッチ識別子を指定するNDIS_NIC_SWITCH_ID値。スイッチ識別子は、0 からネットワークアダプターがサポートするスイッチの数までの整数です。 NDIS_DEFAULT_SWITCH_ID値は、既定のネットワークアダプタースイッチを示します。

メモWindows Server 2012以降、SR-IOV インターフェイスは、ネットワークアダプターで作成される既定のネットワークアダプタースイッチのみをサポートします。したがって、このメンバーは常に NDIS_DEFAULT_SWITCH_ID に設定する必要があります。

FirstElementOffset

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

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

NumElements

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

ElementSize

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

注釈

NDIS は、 OID_NIC_SWITCH_ENUM_VFS の OID メソッド要求を処理するときに、 NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体を返します。 NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体に続く配列内の各要素は、
NDIS_NIC_SWITCH_VF_INFO 構造体。