次の方法で共有


NDIS_NIC_SWITCH_INFO 構造体 (ntddndis.h)

NDIS_NIC_SWITCH_INFO構造体は、ネットワーク アダプターのネットワーク アダプター スイッチに関する情報を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

メンバー

Header

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

ミニポート ドライバーは、ヘッダーType メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_NIC_SWITCH_INFO構造体のバージョンを指定するには、ドライバーで HeaderRevision メンバーを次の値に設定する必要があります。

NDIS_NIC_SWITCH_INFO_REVISION_1

NDIS 6.30 の元のバージョン。

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

Flags

スイッチで有効になっている構成フラグのビットごとの OR を含む ULONG 値。

メモ NDIS 6.30 の場合、スイッチの構成フラグは定義されていません。 Flags メンバーは 0 に設定する必要があります。
 

SwitchType

スイッチ 種類を指定するNDIS_NIC_SWITCH_TYPE値。

SwitchId

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

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

SwitchFriendlyName

スイッチのわかりやすい説明を含むNDIS_NIC_SWITCH_FRIENDLYNAME値。

NumVFs

ネットワーク アダプターで有効になっている PCI Express (PCIe) 仮想関数 (VFs) の数を指定する ULONG 値。 有効な VM は、割り当て済み状態または未割り当て状態のいずれかになります。

NumAllocatedVFs

SwitchId で指定されたネットワーク アダプター スイッチに割り当てられている VM の数を指定する ULONG 値。 VM は、 OID_NIC_SWITCH_ALLOCATE_VFの OID セット要求を介して割り当てられます。

NumVPorts

SwitchId で指定されたネットワーク アダプター スイッチで構成されている仮想ポート (VPort) の数を指定する ULONG 値。

この ULONG 値は、次の合計です。

  • OID_NIC_SWITCH_CREATE_VPORTの OID セット要求を通じて作成できる VPort の最大数。
  • 物理関数 (PF) にアタッチされている既定の VPort。

NumActiveVPorts

SwitchId で指定されたネットワーク アダプター スイッチに作成された VPort の数を指定する ULONG 値。

メモ この ULONG 値には、OID_NIC_SWITCH_CREATE_VPORT の OID セット要求によって作成された既定以外の VPort に加えて、既定の VPort が含まれます
 

NumQueuePairsForDefaultVPort

既定の VPort に割り当てられたキュー ペアの数を指定する ULONG 値。 既定の VPort は常に PF にアタッチされます。

キュー ペアは、送信キューと受信キューで構成されます。 ミニポート ドライバーは、OID_NIC_SWITCH_CREATE_SWITCH の OID メソッド要求を使用して、スイッチの作成時に既定の VPort に 1 つ以上のキュー ペア 関連付けます。

メモ NDIS 6.30 以降では、既定の VPort 用に構成できるキュー ペアは 1 つだけです。
 

NumQueuePairsForNonDefaultVPorts

既定以外の VPort に割り当てられたキュー ペアの数を指定する ULONG 値。 既定以外の VPort は、PF またはネットワーク アダプターの VF のいずれかに接続できます。

ミニポート ドライバーは、OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を通じて、既定以外の VPort に 1 つ以上のキュー ペア 関連付けます。

NumActiveDefaultVPortMacAddresses

ネットワーク アダプターの PF に接続されている既定の VPort で現在設定されているユニキャスト MAC アドレス フィルターの数を指定する ULONG 値。

NumActiveNonDefaultVPortMacAddresses

既定以外の VPort で現在設定されているユニキャスト MAC アドレス フィルターの数を指定する ULONG 値。

NumActiveDefaultVPortVlanIds

既定の VPort で現在設定されている仮想ローカル エリア ネットワーク (VLAN) 識別子フィルターの数を指定する ULONG 値。

NumActiveNonDefaultVPortVlanIds

既定以外の VPort で現在設定されている VLAN 識別子フィルターの数を指定する ULONG 値。

注釈

NDIS_NIC_SWITCH_INFO構造体は、OID_NIC_SWITCH_ENUM_SWITCHESの OID クエリ要求で使用されます。 この OID 要求は、ネットワーク アダプターのネットワーク アダプター スイッチを列挙するために使用されます。 この OID 要求が発行されると、 NDIS_NIC_SWITCH_INFO_ARRAY 構造体内で 1 つ以上の NDIS_NIC_SWITCH_INFO 構造体が返されます。

メモ NDIS 6.30 以降では、既定のネットワーク アダプター スイッチに関する情報を記述する NDIS_NIC_SWITCH_INFO のみが 、OID_NIC_SWITCH_ENUM_SWITCHES の OID 要求を通じて返されます。
 
NDIS_NIC_SWITCH_INFO構造体には、OID_NIC_SWITCH_CREATE_SWITCHの OID メソッド要求によって以前に作成されたネットワーク アダプター スイッチに関する情報が含まれています。

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

要件

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

こちらもご覧ください

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT