NDIS_NIC_SWITCH_PARAMETERS 構造体 (ntddndis.h)

[アーティクル]
12/21/2023

NDIS_NIC_SWITCH_PARAMETERS構造体は、ネットワークアダプターのネットワークアダプタースイッチの構成パラメーターを指定します。

構文

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

メンバー

Header

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

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

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

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーには、次のフラグが定義されています。

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

このフラグは、 NDIS_NIC_SWITCH_PARAMETERS 構造体で更新されたフィールドが SwitchName メンバーであることを指定します。

メモこのフラグは、この構造体が OID_NIC_SWITCH_PARAMETERS の OID セット要求で使用されている場合にのみ有効です。

SwitchType

ネットワークアダプタースイッチの種類を指定するNDIS_NIC_SWITCH_TYPE列挙値。

メモWindows Server 2012以降、Windows では NdisNicSwitchTypeExternal のスイッチの種類のみがサポートされています。外部スイッチは、この種類のスイッチに接続されているポートが、ネットワークアダプターの物理ポートを介して外部ネットワークにアクセスできることを指定します。外部スイッチの既定の仮想ポート (VPort) は、Hyper-V 親パーティションの管理オペレーティングシステムで実行される仮想化スタックへの外部ネットワーク接続を提供します。

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 値。 NdisMEnableVirtualization の呼び出しによって仮想化が有効になっている場合、アダプターで VM が有効になります。

メモ HYPER-V 子パーティションに VF をアタッチする前に、 OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求を介してリソースを割り当てる必要があります。

NdisReserved1

NDIS 用に予約されています。

NdisReserved2

NDIS 用に予約されています。

NdisReserved3

NDIS 用に予約されています。

NumQueuePairsForDefaultVPort

注釈

NDIS_NIC_SWITCH_PARAMETERS構造体は、OID_NIC_SWITCH_CREATE_SWITCHおよびOID_NIC_SWITCH_PARAMETERSの OID メソッド要求で使用されます。これらの OID 要求は、ネットワークアダプタースイッチの構成パラメーターを設定またはクエリします。

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