NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 構造体 (ntddndis.h)

[アーティクル]
03/05/2024

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY構造体は配列を指定します。配列内の各要素は、ネットワークアダプターのネットワークアダプタースイッチに作成された仮想ポート (VPort) の属性を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

メンバー

Header

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

NDIS は、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定します。 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY構造体のバージョンを指定するには、NDIS ヘッダーのリビジョン メンバーを次の値に設定します。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

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

Flags

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

このフラグは、特定の PCI Express (PCIe) 関数に接続されている VPort を列挙することを指定します。関数は AttachedFunctionId メンバーで指定されます。このフラグを使用すると、PCIe 物理関数 (PF) または指定された PCIe 仮想関数 (VF) に接続されている VPort を列挙できます。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

このフラグは、SwitchId で指定された特定のスイッチで作成された VPort を列挙することを指定します。これにより、スイッチで作成されたすべての VPort が列挙されます。

メモこれらのフラグは相互に排他的です。 Flags メンバーで設定できるフラグは 1 つだけです。

SwitchId

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

SwitchId メンバーは、flags メンバーでNDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCHが指定されている場合にのみ有効です。

メモWindows Server 2012以降、単一ルート I/O 仮想化 (SR-IOV) インターフェイスでは、ネットワークアダプターの既定のネットワークアダプタースイッチのみがサポートされます。このメンバーの値は、NDIS_DEFAULT_SWITCH_IDに設定する必要があります。

AttachedFunctionId

ネットワークアダプター上の PF または VF の識別子を指定するNDIS_SRIOV_FUNCTION_ID値。

メモこの値がNDIS_PF_FUNCTION_ID場合、VPort は PF にアタッチされます。

AttachedFunctionId メンバーは、flags メンバーでNDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTIONが指定されている場合にのみ有効です。

FirstElementOffset

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

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

NumElements

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

ElementSize

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

注釈

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

SR-IOV インターフェイスの詳細については、「単一ルート I/O 仮想化 (SR-IOV) の概要」を参照してください。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.30 以降でサポートされています。
Header	ntddndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

次の方法で共有