詳細プロパティ ページの構成パラメーターの指定
Note
Windows 10 バージョン 1703 より前では、ドライバーのアップグレードと Windows 更新プログラムにより、ドライバーが以前に「詳細」なプロパティ ページで定義した INF 値が変更される可能性があります。 Windows 10 バージョン 1703 以降では、ドライバーが INF ファイルで指定する詳細なプロパティは、これらの更新プログラムによって保持されます。
Net コンポーネント (アダプター) をインストールする INF ファイルでは、コンポーネントの「詳細」なプロパティ ページに表示するアダプター構成パラメーターを指定できます。 「詳細」なプロパティ ページでユーザーが指定した構成値は、コンポーネントのルート インスタンス キーに書き込まれます。
アダプターが「詳細」なプロパティ ページをサポートしている場合、アダプターの DDInstall セクションの「特性」エントリに NCF_HAS_UI 値が含まれている必要があることに注意してください。
ネットワーク INF ファイルは、コンポーネントの DDInstall セクションによって参照されるレジストリの追加セクションを介して詳細ページに表示するための構成パラメーターを指定します。 このようなレジストリの追加セクションは、1 つ以上の構成サブキーを 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 に追加される各パラメーター サブキーについて、レジストリの追加セクションに ParamDesc (パラメーターの説明) と型の値を追加する必要があります。 レジストリの追加セクションでは、パラメーターの既定値と省略可能な値を追加することもできます。パラメーターが数値の場合は、最小、最大、ステップの値です。 次の表では、各 Ndi\params キーに追加できる値について 説明します。
| 名前 | 値 | 説明 |
|---|---|---|
ParamDesc |
String |
「詳細」ページにパラメーターの名前が表示される |
Type |
int、 long、 Word、 dword、 edit、または enum |
パラメーターの型: int、long、Word、dword は数値パラメーターを指定します。 edit と enum はテキスト パラメーターを指定します。 |
既定値 |
既定値 |
パラメーターの既定値: 数値パラメーターの場合は、指定したパラメーター型に一致する数値 ( int、 long、 Word、または dword) である必要があります。テキスト パラメーターの場合は、文字列である必要があります。 必須なパラメーターには既定値を指定する必要があります。 省略可能なパラメーターに既定値を指定することもできます。 省略可能なパラメーターの値を入力するオプションをユーザーが選択すると、そのパラメーターの編集ボックスに既定値 (指定されている場合) が表示されます。 |
省略可能 |
0 または 1 |
0 必須。 パラメータの値を指定するか、既定値を使用します。 1 省略可能。 「詳細」ページで「存在しない」をマークできます。 |
分 |
数値 |
数値パラメーターの最小値。 |
最大 |
数値 |
数値パラメーターの最大値。 |
手順 |
数値 |
数値パラメーターの有効な値の間のステップ (間隔)。 最小値は開始点です。 |
列挙型パラメーターの値の範囲は、次の形式のサブキーで指定されます。
Ndi\params\SubKeyName\enum
各列挙値にはサブキーが必要です。 各列挙型 サブキーは、数値 (最初の列挙値の場合は 0 から始まる) とその値の説明を指定します。
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)"