指定進階屬性頁面的組態參數

注意

在Windows 10版本 1703 之前，驅動程式升級和 Windows 更新可能會導致驅動程式先前在 [進階屬性] 頁面中定義的 IN光圈值變更。 從 Windows 10 1703 版開始，驅動程式在其 INF 檔案中指定的進階屬性會透過這些更新保存。

安裝 Net 元件 (配接器的 INF 檔案) 可以指定配接器組態參數，以顯示在元件的 [ 進階 屬性] 頁面中。 使用者在 [ 進階 屬性] 頁面中指定的組態值會寫入元件的根實例索引鍵。

請注意，如果介面卡支援 [進階屬性] 頁面，則介面卡的 [DDInstall] 區段中的[特性] 專案必須包含NCF_HAS_UI值。

網路 INF 檔案會指定組態參數，以透過元件的DDInstall區段所參考的add-registry-section顯示在 [進階] 頁面中。 這類 add-registry-section 會將一或多個設定子機碼新增至 Ndi\params 機碼。 組態參數子機碼的格式為 Ndi\params\SubKeyName，其中 SubKeyName 是指定廠商特定參數名稱的REG_SZ值。 例如，指定擷取類型之參數的索引鍵可以命名為 Ndi\params\Type。

下列關鍵字是保留的，無法當做Ndi\params\SubKeyName使用：BundleId、BusType、Characteristics、ComponentId、Description、DeviceInstanceId、DriverDate、DriverDesc、DriverVersion、InfPath、InfSection、InfSectionExt、**IfType* InstallTimeStamp、Manufacturer、** MediaType、**NetCfgInstanceId、NetLuidIndex、PhysicalMediaType、**Provider和 **ProviderName。

對於新增至 Ndi\params的每個參數子機碼， add-registry-section 必須新增 ParamDesc (參數描述) 和 Type 值。 add-registry-section也可以新增參數的Default和Optional值，如果參數是 numeric、Min、Max 和Step值，則為 。 下表描述可新增至每個 Ndi\params 索引鍵的值。

名稱	值	描述
ParamDesc	String	在 [ 進階 ] 頁面上為 參數顯示的名稱
類型	int、long、Word、dword、edit或enum	參數類型：int、long、Word和dword指定數值參數;編輯和列舉指定文字參數。
預設	預設值	參數的預設值：對於數值參數，必須是符合指定參數類型的數值 ( int、long、Word或dword) ;如果是 text 參數，則必須是字串。 必須針對必要的參數指定預設值。 您也可以為選擇性參數指定預設值。 當使用者選取選項來輸入選擇性參數的值時，如果指定預設值，就會出現在該參數的編輯方塊中。
選擇性	0 或 1	需要 0 。 指定 參數的值，或使用預設值。 1 個選擇性。 可以在 [進階] 頁面上標示為[不存在]。
最小值	數值	數值參數的最小值。
最大值	數值	數值參數的最大值。
步驟	數值	步驟 (數值參數的有效值之間的間隔) 。 最小值是起點。

列舉參數的值範圍是使用具有下列格式的子機碼來指定：

Ndi\params\SubKeyName\enum

每個列舉值都必須有子機碼。 每個 列舉 子機碼都會指定數值 (從第一個列舉值) 的零開始，以及該值的描述。

以下是 add-registry-section 的範例，該區段會新增名為 TransType的組態參數。

[a1.params.reg]
HKR, Ndi\params\TransType,      ParamDesc, 0, "Transceiver Type"
HKR, Ndi\params\TransType,      Type,      0, "enum"
HKR, Ndi\params\TransType,      Default,   0, "0"
HKR, Ndi\params\TransType,      Optional,  0, "0"
HKR, Ndi\params\TransType\enum, "0",       0, "Auto-Connector"
HKR, Ndi\params\TransType\enum, "1",       0, "Thick Net(AUI/DIX)"
HKR, Ndi\params\TransType\enum, "2",       0, "Thin Net (BNC/COAX)"
HKR, Ndi\params\TransType\enum, "3",       0, "Twisted-Pair (TPE)"