次の方法で共有


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

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

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

要件

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

こちらもご覧ください

NDIS_OBJECT_HEADER

NdisMEnableVirtualization

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS