NDIS_NIC_SWITCH_PARAMETERS構造体 (ntddndis.h)

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 構造体として書式設定されます。

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

Size メンバーを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 の呼び出しによって仮想化が有効になっている場合、アダプターで VFs が有効。

注 VF を Hyper-V 子パーティションにアタッチする前に、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)を参照してください。

必要条件

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

関連項目

NDIS_OBJECT_HEADER

NdisMEnableVirtualization の

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS