指定 [進階屬性] 頁面的組態參數
注意
在 Windows 10 版本 1703 之前,驅動程式升級和 Windows 更新可能會導致驅動程式先前在 進階 屬性頁面中定義的 INF 值變更。 從 Windows 10 版本 1703 開始,驅動程式在其 INF 檔案中指定的進階屬性會透過這些更新保存。
安裝 Net 元件 (adapter) 的 INF 檔案可以指定配接器組態參數,以顯示在元件的 進階 屬性頁面中。 用戶在 Advanced 屬性頁面中指定的組態值會寫入元件的根實例索引鍵。
請注意,如果配接器支援 Advanced 屬性頁面,配接器 DDInstall 區段中 特性 項目必須包含NCF_HAS_UI值。
網路 INF 檔案會透過元件的 DDInstall 區段所參考的 add-registry-section,指定在進階頁面中顯示的組態參數。 這類 add-registry-section 會將一或多個組態子機碼新增至 Ndi\params 機碼。 組態參數子機碼的格式為 Ndi\params\SubKeyName,其中 SubKeyName 是一個 REG_SZ 值,用來指定特定廠商參數名稱。 例如,指定一種收發器類型的參數的索引鍵可以命名為 Ndi\params\TransceiverType。
下列關鍵詞為保留,不能作為 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 也可以新增 預設值 和 可選的值,如果參數是數值,則有 Min、Max和 Step 值。 下表描述可添加到每個 Ndi\params 鍵的值。
名字 | 價值 | 描述 |
---|---|---|
ParamDesc |
字串 |
在[進階]頁面中顯示參數的名稱 |
類型 |
int、long、Word、dword、edit或 枚舉 |
參數類型: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)"