指定進階屬性頁面的組態參數
注意
在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)"