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 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_NIC_SWITCH_INFO 構造体のバージョンを指定するには、ドライバーは、ヘッダー の リビジョン メンバーを次の値に設定する必要があります。
NDIS_NIC_SWITCH_INFO_REVISION_1
NDIS 6.30 の元のバージョン。
Size メンバーを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 要求を通じて返されます。
SR-IOV インターフェイスの詳細については、「シングル ルート I/O 仮想化の概要 (SR-IOV)を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.30 以降でサポートされています。 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |
関連項目