INF BitReg-instructie

Een BitReg-instructie verwijst naar een of meer inF-schrijver gedefinieerde secties die worden gebruikt om bits in te stellen of te wissen binnen een bestaande REG_BINARY-type waardevermelding in het register. Deze richtlijn wordt echter zelden gebruikt in INF-bestanden van het apparaat/stuurprogramma.

[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)
 
BitReg=bit-registry-section[,bit-registry-section]...

Een BitReg-instructie kan worden opgegeven onder een van de secties die in de bovenstaande formele syntaxisinstructie worden weergegeven. Deze richtlijn kan ook worden opgegeven onder een van de volgende INF-writer-gedefinieerde secties:

• Een sectie service-install-section of event-log-install waarnaar wordt verwezen door de AddService-instructie in een sectie DDInstall.Services.
• Een add-interface-section waarnaar wordt verwezen door de AddInterface-instructie in een DDInstall. Sectie Interfaces .
• Een install-interface-section waarnaar wordt verwezen in een InterfaceInstall32-sectie

Elke benoemde sectie waarnaar wordt verwezen door een BitReg-instructie heeft de volgende vorm:

[bit-registry-section]
reg-root, [subkey], value-entry-name, [flags], byte-mask, byte-to-modify
reg-root, [subkey], value-entry-name, [flags], byte-mask, byte-to-modify
...

Een bitregistersectie kan een willekeurig aantal vermeldingen bevatten, elk op een afzonderlijke regel.

Invoer

reg-root
Identificeert de hoofdmap van de registerstructuur voor andere waarden die in deze vermelding zijn opgegeven. De waarde kan een van de volgende zijn:

HKCR
Afkorting voor HKEY_CLASSES_ROOT.

HKCU
Afkorting voor HKEY_CURRENT_USER.

HKLM
Afkorting voor HKEY_LOCAL_MACHINE.

HKU
Afkorting voor HKEY_USERS.

HKR
Relatieve hoofdmap - dat wil gezegd, sleutels die met deze afkorting worden opgegeven, zijn relatief ten opzichte van de registersleutel die is gekoppeld aan de INF-sectie waarin deze BitReg-instructie wordt weergegeven, zoals aangegeven in de volgende tabel.

Zie Registerstructuren en sleutels voor apparaten en stuurprogramma's voor apparaten en stuurprogramma's voor meer informatie over stuurprogrammagegevens die zijn opgeslagen in de hoofdmap van de HKEY_LOCAL_MACHINE.

Subsleutel
Deze optionele waarde, uitgedrukt als een %strkey% token dat is gedefinieerd in een sectie Tekenreeksen van de INF of als registerpad onder de opgegeven reg-root (key1\key2\key3...), geeft de sleutel op die de waardevermelding bevat die moet worden gewijzigd.

waarde-vermelding-naam
Hiermee geeft u de naam van een bestaande REG_BINARY-type waardevermelding in de (bestaande) subsleutel die moet worden gewijzigd. Het kan worden uitgedrukt als 'aanhalingstekenreeks' of als een %strkey% token dat is gedefinieerd in de sectie Tekenreeksen van INF.

flags
Deze optionele hexadecimale waarde, uitgedrukt als een ORed-bitmasker van door het systeem gedefinieerde lage woord- en hoge woordvlagwaarden, geeft aan of de bits die zijn opgegeven in het opgegeven bytemasker moeten worden gewist of ingesteld. De standaardwaarde is nul, waarmee de bits in de 64-bits sectie van het register worden gewist.

Bitmaskerwaarden voor elk van deze vlaggen zijn als volgt:

0x00000000 (FLG_BITREG_CLEARBITS)
Wis de bits die zijn opgegeven door bytemasker.

0x00000001 (FLG_BITREG_SETBITS)
Stel de bits in die zijn opgegeven door bytemasker.

0x00004000 (FLG_BITREG_32BITKEY) (Windows XP en latere versies van Windows.)
Breng de opgegeven wijziging aan in het 32-bits register. Als dit niet is opgegeven, wordt de wijziging aangebracht in het systeemeigen register.

bytemasker
Dit byte-formaat masker, uitgedrukt in hexadecimale notatie, geeft aan welke bits moeten worden gewist of ingesteld in de huidige waarde van de opgegeven waarde-vermelding-naam.

byte-to-modify
Deze byte-size waarde, uitgedrukt in decimalen, geeft de op nul gebaseerde index van de byte binnen de REG_BINARY-type waarde die moet worden gewijzigd.

Remarks

Elke bit-register-sectienaam moet uniek zijn voor het INF-bestand, maar kan worden verwezen door BitReg-instructies in andere secties van hetzelfde INF. Elke door INF-schrijver gemaakte sectienaam moet uniek zijn binnen het INF-bestand en moet voldoen aan de algemene regels voor het definiëren van sectienamen. Zie Algemene syntaxisregels voor INF-bestanden voor meer informatie over deze regels.

De waarde van een bestaande REG_BINARY-type waardevermelding kan ook worden gewijzigd door de huidige waarde te overschrijven in een sectie voor het toevoegen van een register elders in het INF-bestand. Zie de verwijzing voor de AddReg-instructie voor meer informatie over de secties voor het toevoegen van registers.

Voor het gebruik van een BitReg-instructie is de definitie van een andere INF-bestandssectie vereist. De waarde van een bestaande REG_BINARY-type waardevermelding kan echter worden gewijzigd in een dergelijke sectie, waardoor de waarden van alle resterende bits behouden blijven.

Examples

In het volgende voorbeeld ziet u een bitregistersectie voor een fictieve toepassing.

[AppX_BitReg]
; set first bit of byte 0 in ProgramData value entry
HKLM,Software\AppX,ProgramData,1,0x01,0 
; preceding would change value 30,00,10 to 31,00,10

; clear high bit of byte 2 in ProgramData value entry
HKLM,Software\AppX,ProgramData,,0x80,2
; preceding would change value 30,00,f0 to 30,00,70

; set second and third bits of byte 1 in ProgramData value entry
HKLM,Software\AppX,ProgramData,1,0x06,1
; preceding would change value 30,00,f0 to 30,06,f0

Zie ook

AddInterface

AddReg

AddService

ClassInstall32

DDInstall

DDInstall. CoInstallers

DDInstall. HW

InterfaceInstall32