NDIS_NIC_SWITCH_INFO 構造体 (ntddndis.h)

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

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構造体のバージョンを指定するには、ドライバーで Header の Revision メンバーを次の値に設定する必要があります。

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)」を参照してください。