SR-IOV 的標準化 INF 關鍵字
本主題描述單一根目錄 I/O 虛擬化 (SR-IOV) 介面的標準化 INF 關鍵字。 這些關鍵字適用于 PCI Express (PCIe) 實體函式的 INF 檔案, (SR-IOV 網路介面卡的 PF) 。
下列各節將說明 SR-IOV INF 關鍵字:
啟用或停用 SR-IOV 支援的標準化 INF 關鍵字
已定義標準化 INF 關鍵字,以啟用或停用網路介面卡的 SR-IOV 功能支援。
*SRIOV
值,描述裝置是否已啟用或停用 SR-IOV 功能。
安裝驅動程式之後,系統管理員可以在網路介面卡的 [進階] 屬性頁中更新*SRIOV關鍵字值。 如需進階屬性的詳細資訊,請參閱 指定進階屬性頁面的組態參數。
注意 在介面卡的 [ 進階 ] 屬性頁進行變更之後,就會自動重新開機迷你埠驅動程式。
*SriovPreferred
值,定義是否應該啟用 SR-IOV 功能,而不是虛擬機器佇列 (VMQ) ,或接收 (RSS) 功能。
這是隱藏的關鍵字值,不能在 INF 檔案中指定,而且不會顯示在網路介面卡的 [進階 ] 屬性頁中。
如需如何解譯 SR-IOV、VMQ 和 RSS 關鍵字的詳細資訊,請參閱 處理 SR-IOV、VMQ 和 RSS 標準化 INF 關鍵字。
SR-IOV 標準化 INF 關鍵字是列舉關鍵字,如下表所述。 下表中的資料行描述列舉關鍵字的下列屬性:
SubkeyName
您必須在 INF 檔案中指定的關鍵字名稱。 此名稱也會出現在網路介面卡 的 NDI\params\ 機碼之下的登錄中。
ParamDesc
與 SubkeyName 關鍵字相關聯的顯示文字。
注意 獨立硬體廠商 (IHV) 可以定義 SubkeyName 的任何描述性文字。
值
與清單中的每個 SubkeyName 關鍵字相關聯的列舉整數值。
EnumDesc
與功能表中顯示的每個值相關聯的顯示文字。
SubkeyName | ParamDesc | 值 | EnumDesc |
---|---|---|---|
*SRIOV | SR-IOV | 0 | 已停用 |
1 (預設) | 啟用 | ||
*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 交換器的組態。 這可讓網路安裝程式將預設交換器組態資訊從 INF 複製到預設交換器子機碼下的迷你埠登錄組態, (NDI\params\NicSwitches\0) 。
這些關鍵字不會顯示在網路介面卡的 [ 進階 ] 屬性頁中,而且無法由使用者設定。 這些關鍵字是使用 INF 檔案之 DDInstall區段中的AddReg指示詞來指定。 每個關鍵字都是由個別 的 AddReg 指示詞指定。
下表描述 SR-IOV 網路介面卡預設 NIC 交換器組態的 INF 關鍵字。 下表中的資料行描述這些關鍵字的下列屬性:
SubkeyName
您必須在 INF 檔案中指定的關鍵字名稱。 此名稱也會出現在網路介面卡的 NDI\params\NicSwitches\0 機碼之下的登錄中。
資料值
與 SubkeyName 關鍵字相關聯的值。
資料類型
資料值的型別。
SubkeyName | 資料值 | 資料類型 | 注意 |
---|---|---|---|
*標誌 | 0 | REG_DWORD | 關鍵字必須指派這個值。 |
*SwitchType | 1 | REG_DWORD | 關鍵字必須指派這個值。 |
*SwitchId | 0 | REG_DWORD | 關鍵字必須指派這個值。 |
*SwitchName | 「Default Switch」 | 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 參數。