次の方法で共有


NDIS_NIC_SWITCH_VF_INFO_ARRAY構造体 (ntddndis.h)

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

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

Size メンバーを 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 構造体。

必要条件

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

関連項目

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS