Direttiva INF BitReg

Articolo
02/12/2024

Attenzione

A partire da Windows 11 versione 22H2, un pacchetto driver che usa questa direttiva non è più idoneo per una firma da Hardware Developer Center.

I pacchetti driver universali e i driver di Windows non possono usare questa direttiva.

Una direttiva BitReg fa riferimento a una o più sezioni definite dal writer INF usate per impostare o cancellare bit all'interno di una voce di valore di tipo REG_BINARY esistente nel Registro di sistema. Tuttavia, questa direttiva viene usata raramente nei file INF di dispositivo/driver.

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

È possibile specificare una direttiva BitReg in una delle sezioni illustrate nell'istruzione di sintassi formale precedente. Questa direttiva può essere specificata anche in una delle sezioni INF-writer-defined seguenti:

Una sezione service-install-section o event-log-install a cui fa riferimento la direttiva AddService in una sezione DDInstall.Services.
Una sezione add-interface a cui fa riferimento la direttiva AddInterface in una DDInstall. Sezione Interfacce .
Sezione install-interface a cui si fa riferimento in una sezione InterfaceInstall32

Ogni sezione denominata a cui fa riferimento una direttiva BitReg ha il formato seguente:

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

Una sezione del Registro di sistema bit può avere un numero qualsiasi di voci, ognuna in una riga separata.

Voci

reg-root
Identifica la radice dell'albero del Registro di sistema per altri valori forniti in questa voce. I possibili valori sono i seguenti:

HKCR
Abbreviazione di HKEY_CLASSES_ROOT.

HKCU
Abbreviazione di HKEY_CURRENT_USER.

HKLM
Abbreviazione di HKEY_LOCAL_MACHINE.

HKU
Abbreviazione di HKEY_USERS.

HKR
Radice relativa , ovvero le chiavi specificate tramite questa abbreviazione sono relative alla chiave del Registro di sistema associata alla sezione INF in cui viene visualizzata questa direttiva BitReg , come indicato nella tabella seguente.

Sezione INF contenente la direttiva BitReg	Chiave del Registro di sistema a cui fa riferimento HKR
Sezione INF DDInstall	Chiave software del dispositivo
INF DDInstall. Sezione HW	Chiave hardware del dispositivo
INF DDInstall. Sezione Servizi	Chiave di Servizi

Nota

HKR non può essere usato in una sezione del Registro di sistema bit a cui si fa riferimento da una sezione INF DefaultInstall .

Per altre informazioni sui driver archiviati nella radice HKEY_LOCAL_MACHINE , vedere Alberi e chiavi del Registro di sistema per dispositivi e driver.

Sottochiave
Questo valore facoltativo, espresso come token %strkey% definito in una sezione Stringhe dell'INF o come percorso del Registro di sistema nella radice reg specificata (key1\key2\key3...), specifica la chiave che contiene la voce di valore da modificare.

value-entry-name
Specifica il nome di una voce valore di tipo REG_BINARY esistente nella sottochiave (esistente) da modificare. Può essere espresso come "stringa tra virgolette" o come token %strkey% definito nella sezione Stringhe di INF.

flags
Questo valore esadecimale facoltativo, espresso come maschera di bit ORed di valori di parola bassa definiti dal sistema e di flag di parole elevate, specifica se cancellare o impostare i bit specificati nella maschera di byte specificata. Il valore predefinito è zero, che cancella i bit nella sezione a 64 bit del Registro di sistema.

I valori di maschera di bit per ognuno di questi flag sono i seguenti:

0x00000000 (FLG_BITREG_CLEARBITS)
Cancellare i bit specificati da byte-mask.

0x00000001 (FLG_BITREG_SETBITS)
Impostare i bit specificati da byte-mask.

0x00004000 (FLG_BITREG_32BITKEY) (Windows XP e versioni successive di Windows).
Apportare la modifica specificata nel Registro di sistema a 32 bit. Se non specificato, la modifica viene apportata al Registro di sistema nativo.

maschera byte
Questa maschera di byte, espressa nella notazione esadecimale, specifica quali bit cancellare o impostare nel valore corrente del valore specificato value-entry-name.

byte-to-modify
Questo valore di byte, espresso in decimale, specifica l'indice in base zero del byte all'interno del valore di tipo REG_BINARY da modificare.

Commenti

Ogni nome della sezione del Registro di sistema di bit deve essere univoco per il file INF, ma può essere fatto riferimento dalle direttive BitReg in altre sezioni dello stesso INF. Ogni nome di sezione creato da INF-writer deve essere univoco all'interno del file INF e deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Il valore di una voce valore di tipo REG_BINARY esistente può anche essere modificato sovrascrivendo il valore corrente all'interno di una sezione del Registro di sistema aggiuntivo altrove nel file INF. Per altre informazioni sulle sezioni del Registro di sistema aggiuntivo, vedere le informazioni di riferimento per la direttiva AddReg .

L'uso di una direttiva BitReg richiede la definizione di un'altra sezione del file INF. Tuttavia, il valore di una voce di valore di tipo REG_BINARY esistente può essere modificato bit per bit in tale sezione, mantenendo così i valori di tutti i bit rimanenti.

Esempio

L'esempio seguente mostra una sezione del Registro di sistema bit per un'applicazione fittizia.

[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