次の方法で共有

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY構造体 (ntddndis.h)

  • [アーティクル]

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 は、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定します。 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 構造体のバージョンを指定するには、NDIS ヘッダー の リビジョン メンバーを次の値に設定します。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

Size メンバーを 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 以降でサポートされています。
ヘッダー ntddndis.h (Ndis.h を含む)

関連項目

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS