INF AddReg-direktiv

Ett AddReg-direktiv refererar till en eller flera INF-skrivdefinierade _add-registry-sections* som används för att ändra eller skapa registerinformation.

[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] ...

Varje tilläggsregisteravsnitt kan ha poster att göra följande:

  • Lägg till nya nycklar, eventuellt med inledande värdeposter, i registret.

  • Lägg till nya värdeposter i befintliga registernycklar.

  • Ändra befintliga värdeposter för vissa nycklar i registret.

Varje namngivet add-registry-section som refereras till av ett AddReg-direktiv har följande format:

[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"]

Ett tilläggsregisteravsnitt kan ha valfritt antal poster, var och en på en separat rad. En INF kan också innehålla ett eller flera valfria avsnitt för add-registry-section.security, där var och en anger en säkerhetsbeskrivning som tillämpas på alla registervärden som beskrivs i ett namngivet add-registry-section.

Inlägg

reg-root
Identifierar roten i registerträdet för andra värden som anges i den här posten. Värdet kan vara något av följande:

HKCR
Förkortning för HKEY_CLASSES_ROOT

HKCU (på engelska)
Förkortning för HKEY_CURRENT_USER

HKLM (engelska)
Förkortning för HKEY_LOCAL_MACHINE

HKU
Förkortning för HKEY_USERS

HKR
Relativ rot, där nycklar som anges med den här förkortningen är relativa till registernyckeln som är associerad med INF-avsnittet där det här AddReg-direktivet visas, enligt följande tabell.

INF-avsnitt som innehåller AddReg-direktivet Registernyckel som refereras av HKR
Avsnittet INF DDInstall Enhetens programvarunyckel
INF DDInstall. HW-avsnitt Enhetens maskinvarunyckel
AVSNITTET INF [service-install-section] Tjänstenyckeln
AVSNITTET INF [event-log-install] EventLog-nyckeln
AVSNITTET INF [add-interface-section] Enhetsgränssnittets registernyckel

Note

HKR kan inte användas i ett tilläggsregisteravsnitt som refereras till från ett INF DefaultInstall-avsnitt.

Mer information om drivrutinsinformation som lagras under roten HKEY_LOCAL_MACHINE finns i Registerträd och nycklar för enheter och drivrutiner.

Undernyckel
Det här valfria värdet, som antingen bildas som en %strkey -% token som definierats i avsnittet Strängar i INF eller som en registersökväg under den angivna reg-rooten (key1\key2\key3...), anger något av följande:

  • En ny undernyckel som ska läggas till i registret i slutet av den angivna registersökvägen.
  • En befintlig undernyckel där de ytterligare värden som anges i den här posten skrivs (eventuellt ersätter värdet för en befintlig namngiven värdepost för den angivna undernyckeln).
  • Både en ny undernyckel som ska läggas till i registret tillsammans med dess första värdepost.

value-entry-name
Det här valfria värdet namnger antingen en befintlig värdepost i den angivna (befintliga) undernyckeln eller skapar namnet på en ny värdepost som ska läggas till i den angivna undernyckeln, oavsett om den redan finns eller är en ny nyckel som ska läggas till i registret. Det här värdet kan uttryckas antingen som "citerad sträng" eller som en %strkey -% token som definieras i avsnittet Strängar i INF. (Om detta utelämnas för ett värde av strängtyp är värdet-entry-name standardvärdet "namnlös" för den här nyckeln.)

Operativsystemet stöder vissa systemdefinierade nyckelord för värde-entry-name . Mer information finns i slutet av det här avsnittet Kommentarer .

flags
Det här valfria hexadecimala värdet, uttryckt som en ORed-bitmask av systemdefinierade låga ord- och höga ordflaggavärden, definierar datatypen för en värdepost och/eller styr åtgärden add-registry.

Bitmaskvärden för var och en av dessa flaggor är följande:

0x00000001 (FLG_ADDREG_BINVALUETYPE)
Det angivna värdet är "rådata". (Det här värdet är identiskt med FLG_ADDREG_TYPE_BINARY.)

0x00000002 (FLG_ADDREG_NOCLOBBER)
Förhindra att ett angivet värde ersätter värdet för en befintlig värdepost.

0x00000004 (FLG_ADDREG_DELVAL)
Ta bort den angivna undernyckeln från registret eller ta bort det angivna värdet-entry-name från den angivna registerundernyckeln.

0x00000008 (FLG_ADDREG_APPEND)
Lägg till ett angivet värde för en befintlig namngiven värdepost. Den här flaggan är endast giltig om FLG_ADDREG_TYPE_MULTI_SZ också har angetts. Det angivna strängvärdet läggs inte till om det redan finns.

0x00000010 (FLG_ADDREG_KEYONLY)
Skapa den angivna undernyckeln, men ignorera alla angivna värde-entry-name och/eller -värden.

0x00000020 (FLG_ADDREG_OVERWRITEONLY)
Återställ endast till det angivna värdet om det angivna värdet-entry-name redan finns i den angivna undernyckeln.

0x00001000 (FLG_ADDREG_64BITKEY)
(Windows XP och senare versioner av Windows.) Gör den angivna ändringen i 64-bitarsregistret. Om det inte anges görs ändringen i det interna registret.

0x00002000 (FLG_ADDREG_KEYONLY_COMMON)
(Windows XP och senare versioner av Windows.) Detta är samma som FLG_ADDREG_KEYONLY men fungerar också i ett delregisteravsnitt i ett INF DelReg-direktiv.

0x00004000 (FLG_ADDREG_32BITKEY)
(Windows XP och senare versioner av Windows.) Gör den angivna ändringen i 32-bitarsregistret. Om det inte anges görs ändringen i det interna registret.

0x00000000 (FLG_ADDREG_TYPE_SZ)
Angiven värdepost och/eller värde är av typen REG_SZ.

Note

Det här värdet är standardtypen för en angiven värdepost, så flaggvärdet kan utelämnas från valfri reg-root=- rad i ett tilläggsregisteravsnitt som körs på en värdepost av den här typen.

0x00010000 (FLG_ADDREG_TYPE_MULTI_SZ)
Den angivna värdeposten och/eller värdet är av registertypen REG_MULTI_SZ. Värdefältet som följer kan vara en lista med strängar avgränsade med kommatecken. Den här specifikationen kräver ingen NULL-avslut för ett angivet strängvärde.

0x00020000 (FLG_ADDREG_TYPE_EXPAND_SZ)
Det angivna värdet-entry-name och/eller -värdet är av registertypen REG_EXPAND_SZ.

0x00010001 (FLG_ADDREG_TYPE_DWORD)
Det angivna värdet-entry-name och/eller -värdet är av registertypen REG_DWORD.

0x00020001 (FLG_ADDREG_TYPE_NONE)
Det angivna värdet-entry-name och/eller -värdet är av registertypen REG_NONE.

0x000B0001 (FLG_ADDREG_TYPE_QWORD)
Det angivna värdet-entry-name och/eller -värdet är av registertypen REG_QWORD.

value
Detta kan också ange ett nytt värde för det angivna värdet-entry-name som ska läggas till i den angivna registernyckeln. Ett sådant värde kan vara ett "ersättningsvärde" för en befintlig namngiven värdepost i en befintlig nyckel, ett värde som ska läggas till (flaggvärde0x00010008) till en befintlig med namnet REG_MULTI_SZ värdepost i en befintlig nyckel, en ny värdepost som ska skrivas till en befintlig nyckel eller den första värdeposten för en ny undernyckel som ska läggas till i registret.

Uttrycket för ett sådant värde beror på vilken registertyp som angetts för flaggan enligt följande:

  • Ett registersträngstypvärde kan uttryckas antingen som en "citerad sträng" eller som en %strkey -% token som definierats i avsnittet Strängar i INF-filen. Ett sådant INF-angivet värde behöver inte innehålla en NULL-avslut i slutet av varje sträng.

  • Ett registervärde av numerisk typ kan uttryckas som ett hexadecimalt värde (med hjälp av 0x-notation) eller decimaltal.

security-descriptor-string
Anger en säkerhetsbeskrivning som ska tillämpas på alla registerposter som skapats av det namngivna avsnittet add-registry-. Security-descriptor-string är en sträng med token som anger DACL-säkerhetskomponenten (D:).

Om inget avsnitt add-registry-section.security har angetts ärver registerposter säkerhetsinställningarna för den överordnade nyckeln.

Om ett avsnitt add-registry-section.security har angetts måste följande ACE inkluderas så att installationer och uppgraderingar av enheter och systemtjänstpaket kan ske:

  • (A;; GA;;; SY) − Beviljar all åtkomst till det lokala systemet.
  • (A;; GA;;; BA) − Beviljar all åtkomst till inbyggda administratörer.

Ange inte ACE-strängar som ger skrivåtkomst till icke-privilegierade användare.

Information om säkerhetsbeskrivningssträngar finns i Security Descriptor Definition Language (Windows). Information om formatet för säkerhetsbeskrivningssträngar finns i Security Descriptor Definition Language (Windows).

Mer information om hur du anger säkerhetsbeskrivningar finns i Skapa säkra enhetsinstallationer.

Remarks

Ett AddReg-direktiv kan anges under något av de avsnitt som visas i den formella syntaxöversikten ovan. Det här direktivet kan också anges under något av följande INF-skrivardefinierade avsnitt:

Varje tilläggsregisteravsnittsnamn måste vara unikt för INF-filen, men det kan refereras till av AddReg-direktiv i andra delar av samma INF. Varje avsnittsnamn måste följa de allmänna reglerna för att definiera avsnittsnamn som beskrivs i Allmänna syntaxregler för INF-filer.

Note

Den lägre ordningen på det låga ordet i ett flaggvärde skiljer mellan tecken och binära data.

Om du vill representera ett antal andra registertyper än någon av de fördefinierade REG_XXX-typerna anger du ett nytt typnummer i det höga ordet i flaggan ORed med FLG_ADDREG_BINVALUETYPE i det låga ordet.

Data för ett sådant värde måste anges i binärt format som en sekvens med byte avgränsade med kommatecken. Om du till exempel vill lagra 16 byte data av en ny registerdatatyp, till exempel 0x38, som en värdepost, skulle posten i avsnittet add-registry vara ungefär så här:

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

Den här tekniken kan användas för att definiera nya registertyper för numeriska värden, men inte för värden av typen REG_EXPAND_SZ, REG_MULTI_SZ, REG_NONE eller REG_SZ. Mer information om dessa typer finns i Registervärdetyper.

Nyckelord för specialvärde-entry-name

Särskilda nyckelord definieras för användning i HKR AddReg-posterna . Formatet för de poster som använder dessa nyckelord är följande:

[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"] ,

Följande beskriver de HKR AddReg-poster som använder dessa särskilda nyckelord:

DeviceCharacteristics
En DeviceCharacteristics HKR AddReg-post anger enhetens egenskaper. Egenskapsvärdet är ett numeriskt värde som är resultatet av att använda ELLER på en eller flera FILE_* filegenskaper, som definieras i Wdm.h och Ntddk.h.

Endast följande värden kan anges i en 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

En beskrivning av dessa värden finns i IoCreateDevice.

Egenskapsvärdena, som anges med hjälp av en DeviceCharacteristics-post , är ORed med de som anges i varje anrop till IoCreateDevice som skapar ett enhetsobjekt i enhetsstacken. ÅTGÄRDEN OR inträffar när alla enhetsobjekt har lagts till, men innan enheten startas.

Egenskapsvärdet (inklusive värdet noll) åsidosätter alla enhetsegenskaper för hela klassen som angavs i det associerade klassinstallationsprogrammet INF.

Mer information om enhetsegenskaper finns i Ange enhetsegenskaper.

DeviceType
En DeviceType HKR AddReg-post anger en enhetstyp för enheten. Enhetstypen är det numeriska värdet för en FILE_DEVICE_XXX-konstant som definierats i Wdm.h eller Ntddk.h. Flaggvärdet för 0x10001 anger att värdet av enhetstyp är en REG_DWORD. Mer information finns i Ange enhetstyper.

En INF för klassinstallation ska ange den enhetstyp som gäller för alla, eller nästan alla, enheter i klassen. Om enheterna i klassen till exempel är av typen FILE_DEVICE_CD_ROM anger du en enhetstyp för 0x02. Om en enhets-INF anger ett värde för DeviceType åsidosätter den det värde som angetts av klassinstallationsprogrammet, om det finns något. Om klassen eller enhetens INF anger ett DeviceType-värde tillämpar PnP-hanteraren den typen på det fysiska enhetsobjekt (PDO) som skapats av enhetens bussdrivrutin.

Security
En Security HKR AddReg-post anger en säkerhetsbeskrivning för enheten. Security-descriptor-string är en sträng med token som anger DACL-säkerhetskomponenten (D:).

En INF för klassinstallation kan ange en säkerhetsbeskrivning för en enhetsklass. En enhets-INF kan ange en säkerhetsbeskrivning för en enskild enhet och åsidosätta säkerheten för klassen. Om klassen och/eller enhetens INF anger en säkerhetsbeskrivningssträng, sprider PnP-hanteraren beskrivningen till alla enhetsobjekt ( DOs) för en enhet. Detta inkluderar funktionsenhetsobjektet (FDO), valfria filter-DOs och PDO: n.

Information om formatet för säkerhetsbeskrivningssträngar finns i dokumentationen om Microsoft Windows SDK.

Mer information om hur du anger säkerhetsbeskrivningar finns i Skapa säkra enhetsinstallationer.

UpperFilters
En UpperFilters HKR AddReg-post anger en PnP-drivrutin för det övre filtret. Den här posten i en DDInstall. HW-avsnittet definierar en eller flera enhetsspecifika övre filterdrivrutiner. I ett ClassInstall32-avsnitt definierar den här posten en eller flera klassomfattande övre filterdrivrutiner.

LowerFilters
En LowerFilters HKR AddReg-post anger en PnP-drivrutin med lägre filter. Den här posten i en DDInstall. HW-avsnittet definierar en eller flera enhetsspecifika drivrutiner med lägre filter. I ett ClassInstall32-avsnitt definierar den här posten en eller flera klassomfattande lägre filterdrivrutiner.

Exklusiv
En exklusiv HKR AddReg-post , om den finns och är inställd på "1", anger att enheten är en exklusiv enhet. Annars behandlas inte enheten som exklusiv. Mer information finns i Ange exklusiv åtkomst till enhetsobjekt.

EnumPropPages32
En EnumPropPages32 HKR AddReg-post anger namnet på en DLL-fil (Dynamic Link Library) som är en enhetsspecifik egenskapssidaprovider. Den anger också namnet på funktionen ExtensionPropSheetPageProc som implementeras av DLL. Mer information om egenskapssidor och funktioner finns i Microsoft Windows Software Development Kit (SDK) för Windows 7 och .NET Framework 4.0.

Important

Både namnet på återanropsfunktionen DLL och ExtensionPropSheetPageProc måste omges av citattecken (" ").

LocationInformationOverride
(Windows XP och senare versioner av Windows) En LocationInformationOverride HKR AddReg-post kan användas för att ange en textsträng som beskriver en enhets fysiska plats. Den åsidosätter den LocationInformation-sträng som enhetens busschaufför tillhandahåller som svar på en IRP_MN_QUERY_DEVICE_TEXT begäran.

ResourcePickerTags
En ResourcePickerTags HKR AddReg-post anger resursväljartaggar för en enhet.

ResourcePickerExceptions
En ResourcePickerExceptions HKR AddReg-post anger de resurskonflikter som tillåts för en enhet.

Examples

Ett AddReg-direktiv refererade till avsnittet (SCSI) Miniport_EventLog_AddReg i det här exemplet under ett INF-skrivardefinierat avsnitt som refereras till av AddService-direktivet i en DDInstall. Tjänsteavsnittet i denna INF.

[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 

Observera att du antingen kan ange flaggvärden i hexadecimalt format, som du ser i exemplet, eller så kan du definiera strängplatshållare, %FLG_ADDREG_TYPE_DWORD% till exempel i avsnittet [Strängar] i varje INF-fil.

Se även

Lägg tillInterface

AddService

BitReg

ClassInstall32

DDInstall

DDInstall. CoInstallers

DDInstall. HW

DDInstall. Gränssnitt

DDInstall. Tjänster

DelReg

InterfaceInstall32

Strängar