INF AddReg ディレクティブ

[アーティクル]
04/08/2024

AddReg ディレクティブは、レジストリ情報の変更または作成に使用される 1 つ以上の INF ライター定義の add-registry セクションを参照します。

[DDInstall] | 
[DDInstall.HW] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows) 
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows) 
[ClassInstall32.ntarm64] | (Windows 10 version 1709 and later versions of Windows) 
[install-interface-section] | 
[service-install-section] | 
[event-log-install] | 
[add-interface-section]

AddReg=add-registry-section[,add-registry-section] ...

各 add-registry-section には、次の操作を行うエントリを含めることができます。

レジストリに新しいキー（場合によっては初期値のエントリ）を追加します。
既存のレジストリキーに新しい値エントリを追加します。
レジストリ内の特定のキーの既存の値エントリを変更します。

AddReg ディレクティブによって参照される各名前付き add-registry-section の形式は次のとおりです。

[add-registry-section]
reg-root,[subkey],[value-entry-name],[flags],[value][,[value]]
reg-root,[subkey],[value-entry-name],[flags],[value][,[value]]
 ...

[[add-registry-section.security]
"security-descriptor-string"]

add-registry-section には、それぞれ個別の行に任意の数のエントリを含めることができます。 INF には、1 つ以上の省略可能な add-registry-section.security セクションを含めることもできます。各セクションでは、名前付き add-registry-section 内で説明されているすべてのレジストリ値に適用されるセキュリティ記述子を指定します。

エントリ

reg-root
このエントリで指定された他の値のレジストリツリーのルートを識別します。値は次のいずれかになります。

HKCR
HKEY_CLAS ROOTの省略形

HKCU
HKEY_CURRENT_USERの省略形

HKLM
HKEY_LOCAL_MACHINEの省略形

HKU
HKEY_USERS の省略形

HKR
次の表に示すように、この省略形を使用して指定されたキーが、この AddReg ディレクティブが表示される INF セクションに関連付けられているレジストリキーを基準とする相対的なものです。

AddReg ディレクティブを含む INF セクション	HKR によって参照されるレジストリキー
INF *DDInstall* セクション	デバイスのソフトウェアキー
INF DDInstall.HW セクション	デバイスのハードウェアキー
INF [service-install-section] セクション	サービスキー
INF [event-log-install] セクション	EventLog キー
INF [add-interface-section] section	デバイスインターフェイスのレジストリキー

Note

HKR は INF DefaultInstall セクション から参照される add-registry-section では使用できません。

HKEY_LOCAL_MACHINEルート下に格納されるドライバー情報の詳細については、デバイスとドライバーのレジストリツリーとキーを参照してください。

subkey
このオプション値は、INFのStringsセクションで定義された%strkey%トークンか、与えられたreg-rootの下のレジストリパス(key1\key2\key3.)として形成され、以下のいずれかを指定する：

指定されたレジストリパスの末尾にあるレジストリに追加する新しいサブキー。
このエントリで指定された追加の値が書き込まれる既存のサブキー (指定されたサブキーの既存の名前付き値エントリの値を置き換える可能性があります)。
レジストリに追加する新しいサブキーと、その初期値エントリの両方。

value-entry-name
この省略可能な値は、指定された (既存の) サブキー 内の既存の値エントリに名前を付けるか、指定した サブキー に追加する新しい値エントリの名前を作成します(既に存在するか、レジストリに追加する新しいキーであるかに関係なく)。この値は、"引用文字列" またはINFのStringsセクションで定義されている%strkey%トークンとして表現することができます。 (文字列型の値に対してこれを省略した場合、 value-entry-name はこのキーの既定の "名前なし" 値エントリになります)。

オペレーティングシステムでは、システム定義の特殊な value-entry-name キーワード (keyword) がサポートされています。詳細については、この記事の「備考」セクションを参照してください。

flags
この省略可能な 16 進数の値は、システム定義の低ワードおよび高ワードフラグ値の ORed ビットマスクとして表され、値エントリのデータ型を定義したり、追加レジストリ操作を制御したりします。

これらの各フラグのビットマスク値は次のとおりです。

0x00000001 (FLG_ADDREG_BINVALUETYPE)
指定された値は "生" データです。 (この値は、FLG_ADDREG_TYPE_BINARYと同じです)。

0x00000002 (FLG_ADDREG_NOCLOBBER)
指定された値が既存の値エントリの値を置き換えないようにします。

0x00000004 (FLG_ADDREG_DELVAL)
指定した サブキー をレジストリから削除するか、指定したレジストリ サブキー から指定した value-entry-name を削除します。

0x00000008 (FLG_ADDREG_APPEND)
指定した値を既存の名前付き値エントリの値に追加します。このフラグは、FLG_ADDREG_TYPE_MULTI_SZも設定されている場合にのみ有効です。指定した文字列値が既に存在する場合、追加されません。

0x00000010 (FLG_ADDREG_KEYONLY)
指定されたサブキーを作成しますが、指定された value-entry-name や value は無視します。

0x00000020 (FLG_ADDREG_OVERWRITEONLY)
指定した value-entry-name が指定されたサブキーに既に存在する場合にのみ、指定された値にリセットします。

0x00001000 (FLG_ADDREG_64BITKEY)
(Windows XP 以降のバージョンの Windows)。64 ビットレジストリで指定した変更を行います。指定しない場合、ネイティブレジストリが変更されます。

0x00002000 (FLG_ADDREG_KEYONLY_COMMON)
(Windows XP 以降のバージョンの Windows)。これはFLG_ADDREG_KEYONLYと同じですが、INF DelReg ディレクティブの del-registry セクションでも機能します。

0x00004000 (FLG_ADDREG_32BITKEY)
(Windows XP 以降のバージョンの Windows)。64 ビットレジストリで指定した変更を行います。指定しない場合、ネイティブレジストリが変更されます。

0x00000000 (FLG_ADDREG_TYPE_SZ)
指定された値のエントリや値は、REG_SZ型です。

Note

この値は、指定した値エントリの既定の型であるため、フラグ値は、この型の値エントリを操作するadd-registryセクション の任意の reg-root= 行から省略できます。

0x00010000 (FLG_ADDREG_TYPE_MULTI_SZ)
指定された値エントリまたは値は、レジストリの種類 REG_MULTI_SZです。次の値フィールドには、コンマで区切られた文字列のリストを指定できます。この仕様では、指定された文字列値に NULL ターミネータは必要ありません。

0x00020000 (FLG_ADDREG_TYPE_EXPAND_SZ)
指定された値エントリ名または値は、REG_EXPAND_SZレジストリの種類です。

0x00010001 (FLG_ADDREG_TYPE_DWORD)
指定された値エントリ名または値は、REG_DWORDレジストリの種類です。

0x00020001 (FLG_ADDREG_TYPE_NONE)
指定された値エントリ名または値は、REG_NONEレジストリの種類です。

value
必要に応じて、指定したレジストリキーに追加する、指定した value-entry-name の新しい値を指定します。このような値には、既存のキー内の既存の名前付き値エントリの "置換" 値、既存のキー内の既存の名前付きREG_MULTI_SZ型の値エントリに追加する値 (フラグ値0x00010008)、既存のキーに書き込む新しい値エントリ、またはレジストリに追加する新しいサブキーの初期値エントリを指定できます。

このような値の式は、フラグ に指定されたレジストリの種類によって異なります。次に示します。

レジストリ文字列型の値は、「引用符で囲まれた文字列」または INF ファイルの Strings セクションで定義された %strkey% トークンとして表すことができます。このような INF で指定された値には、各文字列の末尾に NULL ターミネータを含める必要はありません。
レジストリの数値型の値は、16 進数 (0x 表記を使用) または 10 進数で表すことができます。

security-descriptor-string
名前付き add-registry-section によって作成されたすべてのレジストリエントリに適用されるセキュリティ記述子を指定します。 security-descriptor-string は、DACL (D:) セキュリティコンポーネントを示すトークンを含む文字列です。

add-registry-section.security セクションが指定されていない場合、レジストリエントリは親キーのセキュリティ設定を継承します。

add-registry-section.security セクションが指定されている場合は、デバイスとシステムサービスパックのインストールとアップグレードを実行できるように、次の ACE を含める必要があります。

(A;;ジョージア州;;;SY) - ローカルシステムへのすべてのアクセスを許可します。
(A;;ジョージア州;;;BA) - 組み込み管理者へのすべてのアクセスを許可します。

特権のないユーザーに書き込みアクセス権を付与する ACE 文字列は指定しないでください。

セキュリティ記述子文字列の詳細については、「セキュリティ記述子定義言語 (Windows)」を参照してください。セキュリティ記述子文字列の形式については、「セキュリティ記述子定義言語 (Windows)」を参照してください。

セキュリティ記述子を指定する方法の詳細については、「セキュリティで保護されたデバイスのインストールの作成」を参照してください。

解説

AddReg ディレクティブは、上記の正式な構文ステートメントに示されているセクションのいずれかで指定できます。このディレクティブは、次の INF ライター定義セクションのいずれかで指定することもできます。

INF DDInstall.サービスセクションの AddService ディレクティブで参照される サービスインストールセクション または イベントログインストール セクション。
INF DDInstall.InterfacesセクションのAddInterfaceディレクティブで参照されるadd-interface-sectionです。
INF InterfaceInstall32 セクションで参照される install-interface-section。

各 add-registry セクション名は INF ファイルに対して一意である必要がありますが、同じ INF の他のセクションで AddReg ディレクティブ によって参照できます。各セクション名は、INF ファイルの一般的な構文規則で説明されているセクション名を定義するための一般的な規則に従う必要があります。

Note

フラグ値の下位ワードの下位ビットは、文字データとバイナリデータを区別します。

定義済みの REG_XXX 型の 1 つ以外のレジストリ型の数を表すには、フラグ ORed の上位ワードに新しい型番号を指定し、その下位ワードにFLG_ADDREG_BINVALUETYPEを指定します。

このような値のデータは、コンマで区切られたバイトシーケンスとしてバイナリ形式で指定する必要があります。たとえば、0x38 などの新しいレジストリデータ型の 16 バイトのデータを値エントリとして格納する場合、add-registry セクションエントリは次のようになります。

HKR,,MYValue,0x00380001,1,0,2,3,4,5,6,7,8,9,A,B,C,D,E,F

この手法を使用して、数値の新しいレジストリ型を定義できますが、REG_EXPAND_SZ、REG_MULTI_SZ、REG_NONEまたはREG_SZ型の値には使用できません。これらの型について詳しくは、「レジストリ値の型」をご覧ください。

特殊な value-entry-name キーワード (keyword)

特別なキーワード (keyword)は、HKR AddReg エントリで使用するために定義されます。これらのキーワード (keyword)を使用するエントリの形式は次のとおりです。

[HKR,,DeviceCharacteristics,0x10001,characteristics] 
[HKR,,DeviceType,0x10001,device-type] 
[HKR,,Security,,security-descriptor-string] 
[HKR,,UpperFilters,0x10000,service-name] 
[HKR,,LowerFilters,0x10000,service-name] 
[HKR,,Exclusive,0x10001,exclusive-device] 
[HKR,,EnumPropPages32,,"prop-provider.dll,provider-entry-point"]
[HKR,,LocationInformationOverride,,"text-string"] 
[HKR,,ResourcePickerTags,,"text-string"] 
[HKR,,ResourcePickerExceptions,,"text-string"] ,

次に、これらの特殊なキーワード (keyword)を使用する HKR AddReg エントリについて説明します。

DeviceCharacteristics
DeviceCharacteristics HKR AddReg エントリは、デバイスの特性を指定します。特性値は、Wdm.h および Ntddk.h で定義されている 1 つ以上の FILE_* ファイル特性値で OR を使用した結果である数値です。

INF では、次の値のみを指定できます。

#define FILE_REMOVABLE_MEDIA            0x00000001
#define FILE_READ_ONLY_DEVICE           0x00000002
#define FILE_FLOPPY_DISKETTE            0x00000004
#define FILE_WRITE_ONCE_MEDIA           0x00000008
#define FILE_DEVICE_SECURE_OPEN         0x00000100

これらの値の詳細については、「IoCreateDevice」 を参照してください。

DeviceCharacteristics エントリを使用して指定される特性値は、デバイススタックにデバイスオブジェクトを作成する IoCreateDevice の各呼び出しで指定された値を持つ ORed です。 OR 操作は、すべてのデバイスオブジェクトが追加された後、デバイスが開始される前に発生します。

特性値 (値 0 を含む) は、関連付けられたクラスインストーラー INF で指定されたクラス全体のデバイス特性をオーバーライドします。

デバイス特性の詳細については、「デバイス特性の指定」を参照してください。

DeviceType
DeviceType HKR AddReg エントリは、デバイスのデバイスの種類を指定します。デバイスの種類は、Wdm.h または Ntddk.h で定義されている FILE_DEVICE_XXX 定数の数値です。 0x10001のフラグ値は、デバイスの種類の値が REG_DWORDであることを指定します。詳細については「デバイスの種類の指定」を参照してください。

クラスインストーラー INF では、クラス内のデバイスのすべてまたはほぼすべてのデバイスに適用されるデバイスの種類を指定する必要があります。たとえば、クラス内のデバイスの種類がFILE_DEVICE_CD_ROMの場合は、0x02の デバイスの種類 を指定します。デバイス INF で デバイスの種類 値が指定されている場合は、クラスインストーラーによって設定された値 (存在する場合) がオーバーライドされます。クラスまたはデバイス INF が デバイスタイプ 値を指定する場合、PnP マネージャーは、デバイスのバスドライバーによって作成された 物理デバイスオブジェクト (PDO) にその型を適用します。

セキュリティ
Security HKR AddReg エントリは、デバイスのセキュリティ記述子を指定します。 security-descriptor-string は、DACL (D:) セキュリティコンポーネントを示すトークンを含む文字列です。

クラスインストーラー INF では、デバイスクラスのセキュリティ記述子を指定できます。デバイス INF は、クラスのセキュリティをオーバーライドする個々のデバイスのセキュリティ記述子を指定できます。クラスまたはデバイス INF で セキュリティ記述子文字列 が指定されている場合、PnP マネージャーは、デバイスのすべてのデバイスオブジェクト (DOs) に記述子を伝達します。これには、関数デバイスオブジェクト (FDO)、オプションの フィルター DOs、および PDO が含まれます。

セキュリティ記述子文字列の形式については、Microsoft Windows SDK のドキュメントを参照してください。

セキュリティ記述子を指定する方法の詳細については、「セキュリティで保護されたデバイスのインストールの作成」を参照してください。

UpperFilters
UpperFilters HKR AddReg エントリは、PnP 上位フィルタードライバーを指定します。 DDInstall.HW セクションのこのエントリは、1つ以上のデバイス固有の下位フィルタードライバーを定義します。 ClassInstall32 セクションで、このエントリは1つ以上のクラス全体の下位フィルタドライバを定義します。

LowerFilters
LowerFilters HKR AddReg エントリは、PnP 下位フィルタードライバーを指定します。 DDInstall.HWセクション のこのエントリは、1つ以上のデバイス固有の下位フィルタードライバーを定義します。 ClassInstall32 セクションで、このエントリは1つ以上のクラス全体の下位フィルタドライバを定義します。

[排他]
排他 HKR AddReg エントリが存在し、"1" に設定されている場合は、デバイスが 排他的デバイス であることを指定します。それ以外の場合、デバイスは排他的として扱われません。詳細については、「デバイスオブジェクトへの排他アクセスの指定」を参照してください。

EnumPropPages32
EnumPropPages32 HKR AddReg エントリは、デバイス固有のプロパティページプロバイダーであるダイナミックリンクライブラリ (DLL) ファイルの名前を指定します。また、DLL によって実装される ExtensionPropSheetPageProc コールバック関数の名前も指定します。これらの関数の詳細については、Windows 7 および .NET Framework 4.0 用の Microsoft Windows ソフトウェア開発キット (SDK) を参照してください。

重要

DLL の名前と ExtensionPropSheetPageProc コールバック関数の両方を引用符 (" ") で囲む必要があります。

LocationInformationOverride
(Windows XP 以降のバージョンの Windows) LocationInformationOverride HKR AddReg エントリを使用して、デバイスの物理的な場所を記述するテキスト文字列を指定できます。デバイスのバスドライバーが IRP_MN_QUERY_DEVICE_TEXT 要求に応答して提供する LocationInformation 文字列をオーバーライドします。

ResourcePickerTags
ResourcePickerTags HKR AddReg エントリは、デバイスのリソースピッカータグを指定します。

ResourcePickerExceptions
ResourcePickerExceptions HKR AddReg エントリは、デバイスで許可されるリソースの競合を指定します。

例

AddReg 指示文は、このINFの DDInstall.Services セクションの AddService 指示文によって参照されるINFライタ定義セクションの下で、この例の (SCSI) Miniport_EventLog_AddReg セクションを参照しました。

[Miniport_EventLog_AddReg]
HKR,,EventMessageFile,0x00020000,"%%SystemRoot%%\System32\IoLogMsg.dll" 
; double quotation marks delimiters in preceding entry prevent truncation 
; if line wraps
 
HKR,,TypesSupported,0x00010001,7

例に示すように、フラグ値を 16 進数形式で指定することも、%FLG_ADDREG_TYPE_DWORD%各 INF ファイルの [Strings] セクションなどの文字列プレースホルダーを定義することもできます。

次の方法で共有

INF AddReg ディレクティブ

エントリ

解説

特殊な value-entry-name キーワード (keyword)

例

関連項目

フィードバック

その他のリソース