SR-IOV 用の標準化された INF キーワード
このトピックでは、シングル ルート I/O 仮想化 (SR-IOV) インターフェイスの標準化された INF キーワードについて説明します。 これらのキーワードは、SR-IOV ネットワーク アダプターの PCI Express (PCIe) 物理機能 (PF) のミニポート ドライバーの INF ファイルに適用されます。
以降のセクションでは、SR-IOV INF キーワードについて説明します。
SR-IOV サポートを有効または無効にするための標準化された INF キーワード
既定の NIC スイッチの構成用の標準化された INF キーワード
SR-IOV サポートを有効または無効にするための標準化された INF キーワード
標準化された INF キーワードは、ネットワーク アダプターの SR-IOV 機能のサポートを有効または無効にするために定義されています。
*SRIOV
デバイスが SR-IOV 機能を有効または無効にしたかどうかを示す値。
ドライバーがインストールされると、管理者は、ネットワーク アダプターの「詳細」プロパティ ページの *SRIOV キーワード値を更新できます。 詳細プロパティの詳細は、「詳細プロパティ ページの構成パラメーターの指定」を参照してください。
注: ミニポート ドライバーは、アダプターの「詳細」プロパティ ページで変更が行われた後に自動的に再起動されます。
*SriovPreferred
仮想マシン キュー (VMQ) の代わりに SR-IOV 機能を有効にするか、または受信側スケーリング (RSS) 機能を有効にするかを定義する値。
これは非表示のキーワード値であり、INF ファイルで指定する必要はありません。ネットワーク アダプターの「詳細」プロパティ ページには表示されません。
SR-IOV、VMQ、RSS キーワードを解釈する方法の詳細については「SR-IOV、VMQ、RSS 標準化 INF キーワードの処理」を参照してください。
SR-IOV で標準化された INF キーワードは列挙キーワードであり、次の表で説明します。 この表の列では、列挙キーワードの次の属性について説明します。
SubkeyName
INF ファイルで指定する必要があるキーワードの名前。 この名前は、ネットワーク アダプターの NDI\params\ キーの下のレジストリにも表示されます。
ParamDesc
SubkeyName キーワードに関連付けられている表示テキスト。
注: 独立系ハードウェア ベンダー (IHV) は、SubkeyName の説明テキストを定義できます。
Value
リスト内の各 SubkeyName キーワードに関連付けられている列挙整数値。
EnumDesc
メニューに表示される各値に関連付けられている表示テキスト。
| SubkeyName | ParamDesc | Value | EnumDesc |
|---|---|---|---|
| *SRIOV | SR-IOV | 0 | 無効 |
| 1 (既定値) | Enabled | ||
| *SriovPreferred | このサブキーの ParamDesc エントリと EnumDesc エントリは、INF ファイルまたはユーザー インターフェイスでは使用できません。 | 0 (既定値) | *VmqOrRssPreferrence キーワードに基づいて RSS または VMQ の機能を報告します。 SR-IOV 機能を報告しないでください。 *VmqOrRssPreferrence キーワードの詳細については「VMQ の標準化された INF キーワード」を参照してください。 |
| 1 | SR-IOV 機能を報告します。 |
標準化された INF キーワード の詳細については、「ネットワークデバイスの標準化された INF キーワード」を参照してください。
既定の NIC スイッチの構成用の標準化された INF キーワード
Windows Server 2012 以降では、SR-IOV インターフェイスは、ネットワーク アダプターの既定の NIC スイッチを１つのみサポートします。 このスイッチは既定の NIC スイッチと呼ばれており、NDIS_DEFAULT_SWITCH_ID 識別子で参照します。
PF ミニポート ドライバーの INF ファイルは、SR-IOV ネットワーク アダプターの既定の NIC スイッチの構成を指定する必要があります。 これにより、ネットワーク インストーラーは、既定のスイッチのサブキー (NDI\params\NicSwitches\0) の下のミニポート レジストリ構成に INF から既定のスイッチ構成情報をコピーできます。
これらのキーワードは、ネットワーク アダプターの「詳細」プロパティ ページには表示されず、ユーザーが構成することはできません。 これらのキーワードは、INF ファイルの DDInstall セクションで AddReg ディレクティブを使用して指定します。 各キーワードは、個別の AddReg ディレクティブによって指定されます。
次の表では、SR-IOV ネットワーク アダプターの既定の NIC スイッチ構成の INF キーワードについて説明します。 この表の列では、これらのキーワードの次の属性について説明します。
SubkeyName
INF ファイルで指定する必要があるキーワードの名前。 この名前は、ネットワーク アダプターの NDI\params\NicSwitches\0 キーの下のレジストリにも表示されます。
データ値
SubkeyName キーワードに関連付けられている値。
データの種類
データ値の型。
| SubkeyName | データ値 | データ型 | メモ |
|---|---|---|---|
| *Flags | 0 | REG_DWORD | キーワードには、この値を割り当てる必要があります。 |
| *SwitchType | 1 | REG_DWORD | キーワードには、この値を割り当てる必要があります。 |
| *SwitchId | 0 | REG_DWORD | キーワードには、この値を割り当てる必要があります。 |
| *SwitchName | “既定のスイッチ” | REG_SZ | キーワードには、この値を割り当てる必要があります。 |
| *NumVFs | (0-n)、 | REG_DWORD | n は、SR-IOV ネットワーク アダプターでサポートされている PCIe 仮想関数 (VFs) の最大数です。 注: このレジストリ キーは、ネットワーク アダプターがサポートする VF の最大数を定義します。 ミニポート ドライバーが NdisMSetMiniportAttributes を呼び出すと、ネットワーク アダプターで使用可能なハードウェア リソースに応じて、この値より小さい値をアドバタイズできます。 詳細については「NICスイッチの機能の確認」を参照してください 。 |
SR-IOV ネットワーク アダプターの既定の NIC スイッチ構成の AddReg ディレクティブの例を次に示します。
HKR, NicSwitches\0, *SwitchId, 0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”
AddReg ディレクティブの構文の詳細については「INF AddReg ディレクティブ」を参照してください。
既定の NIC スイッチの詳細については「NIC スイッチ」を参照してください。