Direttiva INF AddPowerSetting

Una direttiva AddPowerSetting fa riferimento a una o più sezioni usate per modificare o creare informazioni sulle impostazioni di risparmio energia. Ogni sezione add-power-setting-section definisce un'impostazione di alimentazione, i valori consentiti per l'impostazione di alimentazione, il nome descrittivo dell'impostazione di alimentazione e la descrizione dell'impostazione di alimentazione. Una sezione add-power-setting-section specifica anche il valore predefinito per ogni personalità dello schema di alimentazione. Per altre informazioni sulle impostazioni di risparmio energia e sulle personalità dello schema di alimentazione, vedere Gestione degli stati delle prestazioni dei dispositivi.

[DDInstall] | 
[DDInstall.HW] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] |  (Windows Vista)
[ClassInstall32.ntamd64] | (Windows Vista)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)

AddPowerSetting=add-power-setting-section[,add-power-setting-section]

In generale, una sezione add-power-setting-include le direttive seguenti:

• Direttiva SubGroup .

• Direttiva Setting

• Elenco di due o più direttive Value o una direttiva ValueRange .

• Un set di sei direttive Predefinite .

Una sezione add-power-setting-section accetta una delle due forme seguenti:

• Se i valori delle impostazioni di risparmio energia consentiti possono essere definiti meglio come set di due o più valori discreti, usare un elenco di direttive Value per specificare i valori consentiti, come indicato di seguito:

  [add-power-setting-section]
  
  [SubGroup = {subgroup-guid}] | SubGroup = {subgroup-guid}, subgroup-name, subgroup-description, subgroup-icon
  Setting = {setting-guid}, [setting-name],[setting-description],[setting-icon]
  Value = value-index, value-name,[value-description], value-flags, value-data 
  Value = value-index, value-name,[value-description], value-flags, value-data
  [Value = value-index, value-name,[value-description], value-flags, value-data
  ...
  Value = value-index, value-name,[value-description], value-flags, value-data]
  
  (Six required Default directives, each one of which has the following form)
  Default = power-scheme-personality-GUID, AC/DC-index, default-setting-index | default-setting-value 
  ...
  

• Se i valori delle impostazioni di risparmio energia consentiti possono essere definiti in modo ottimale come sequenza incrementata di valori interi non negativo all'interno di un intervallo specificato, usare una direttiva ValueRange per specificare i valori consentiti, come indicato di seguito:

  [add-power-setting-section]
  
  [SubGroup = {subgroup-guid}] | 
  SubGroup = {subgroup-guid}, subgroup-name, subgroup-description, subgroup-icon
  Setting = {setting-guid}, [setting-name],[setting-description],[setting-icon]
  ValueRange = range-minimum-value, range-maximum-value, range-increment, [range-unit-label] 
  
  (Six required Default directives, each one of which has the following form)
  Default = power-scheme-personality-GUID, AC/DC-index, default-setting-index | default-setting-value 
  ...
  

Voci

Sottogruppo
Un sottogruppo raggruppa le impostazioni di risparmio energia correlate logicamente.

Per specificare un sottogruppo definito dal sistema, includere una direttiva SubGroup e specificare solo la voce subgroup-guid . I sottogruppi definiti dal sistema sono rappresentati dalle costanti GUID_Xxx_SUBGROUP e NO_SUBGROUP_GUID, definite in Wdm.h.

Ad esempio, GUID_VIDEO_SUBGROUP rappresenta il sottogruppo che contiene le impostazioni di risparmio energia video per una personalità dello schema di alimentazione. La costante NO_SUBGROUP_GUID rappresenta una raccolta di impostazioni che non appartengono logicamente ad alcun sottogruppo. Se non è inclusa una direttiva SubGroup , l'impostazione viene aggiunta per impostazione predefinita alla raccolta di impostazioni che non appartengono logicamente ad alcun sottogruppo.

Per definire un nuovo sottogruppo, includere la direttiva SubGroup e specificare le voci necessarie seguenti: subgroup-guid, subgroup-name, subgroup-description e subgroup-icon. Il GUID del nuovo sottogruppo deve essere univoco e le altre voci devono essere il più descrittive possibile.

subgroup-guid
La voce richiesta fornisce il GUID che identifica il sottogruppo. Il formato di questa voce è {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, dove "X" è una cifra esadecimale.

Ad esempio, il valore della costante definita dal sistema GUID_VIDEO_SUBGROUP è {7516B95F-F776-4464-8C53-06167F40CC99}. Questo GUID rappresenta il sottogruppo che contiene le impostazioni di potenza video per una personalità dello schema di alimentazione.

subgroup-name
Stringa che specifica il nome del sottogruppo dell'impostazione di risparmio energia. Se il sottogruppo è un sottogruppo definito dal sistema, questa voce non deve essere fornita. Se il sottogruppo è nuovo, questa voce è obbligatoria.

subgroup-description
Stringa che descrive all'utente il sottogruppo di alimentazione. Se il sottogruppo è un sottogruppo definito dal sistema, questa voce non deve essere fornita. Se il sottogruppo è nuovo, questa voce è obbligatoria.

icona del sottogruppo
Riferimento a una risorsa icona. Se il sottogruppo è un sottogruppo definito dal sistema, questa voce non deve essere fornita. Se il sottogruppo è nuovo, questa voce è obbligatoria.

Una risorsa icona deve essere specificata come valore del Registro di sistema indipendente dalla lingua. Per informazioni su come specificare un valore del Registro di sistema indipendente dalla lingua, vedere Specifica di un valore di immissione della stringa AddPowerSetting.

impostazione
La direttiva Setting identifica l'impostazione a cui si applicano tutte le altre voci della sezione. Una direttiva Setting è necessaria in una sezione add-power-setting e può essere presente una sola direttiva Setting in una sezione add-power-setting. Se un file INF definisce più di un'impostazione, ogni impostazione deve essere definita nella relativa sezione add-power-setting.

Di seguito sono riportate le voci associate a una direttiva Setting .

setting-guid
Voce obbligatoria che specifica il GUID che rappresenta l'impostazione di alimentazione. Il formato di questa voce è {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXXXX}, dove ogni "X" è una cifra esadecimale.

Ad esempio, di seguito è riportato un valore GUID personalizzato: {BFC0D9E9-549C-483D-AD2A-3D90C98A8B03}.

setting-name
Voce facoltativa che specifica una stringa contenente il nome descrittivo dell'impostazione di alimentazione. Opzioni di risparmio energia in Pannello di controllo visualizza questo nome descrittivo per un utente.

setting-description
Voce facoltativa che specifica una stringa che descrive all'utente l'impostazione di risparmio energia e l'effetto che l'impostazione ha sull'alimentazione e sulle prestazioni di sistema.

icona di impostazione
Voce facoltativa che rappresenta un riferimento a una risorsa icona. Una risorsa icona deve essere specificata da un valore del Registro di sistema indipendente dalla lingua.

Per informazioni su come specificare un valore del Registro di sistema indipendente dalla lingua, vedere Specifica di un valore di immissione di stringhe AddPowerSetting.

Valore
Una direttiva Value definisce un valore consentito per un'impostazione di risparmio energia. La direttiva Value deve essere usata se i valori possono essere definiti meglio come un set di due o più valori, in cui ogni valore può avere un tipo di dati personalizzato specifico del valore. In questo caso, una sezione add-power-setting-section deve includere due o più direttive Value . Un utente può selezionare uno di questi valori in Opzioni risparmio energia in Pannello di controllo per configurare uno schema di alimentazione.

Se i valori di impostazione dell'alimentazione consentiti possono essere descritti meglio come set incrementato di interi non negativi all'interno di un intervallo, usare la direttiva ValueRange anziché la direttiva Value per specificare i valori di impostazione dell'alimentazione consentiti.

value-index
Voce obbligatoria che specifica un valore di indice univoco, maggiore o uguale a zero, utilizzato per fare riferimento al valore di impostazione corrispondente. Opzioni di risparmio energia in Pannello di controllo visualizza i valori delle impostazioni di risparmio energia per un utente in ordine dei valori di indice corrispondenti, dal più basso al più alto.

value-name
Voce obbligatoria che fornisce una stringa che fornisce il nome descrittivo per il valore di impostazione corrispondente. Opzioni di risparmio energia in Pannello di controllo visualizza i nomi descrittivi dei valori delle impostazioni di risparmio energia per un utente.

value-description
Voce facoltativa che fornisce una stringa che descrive all'utente il valore dell'impostazione dell'alimentazione e l'effetto che il valore dell'impostazione ha sulla potenza e sulle prestazioni di sistema.

flag valore
Voce obbligatoria che specifica il tipo di dati della voce di dati valore corrispondente, come indicato nella tabella seguente.

value-data
Voce obbligatoria che fornisce i dati per il valore di impostazione corrispondente, il cui formato dipende dal tipo di dati specificato dalla voce dei flag di valore corrispondente, come indicato di seguito:

• Un valore REG_BINARY può essere specificato in formato esadecimale usando la notazione 0x o come elenco delimitato da virgole di numeri esadecimali abbinati senza la notazione 0x.

  Ad esempio, le voci seguenti sono equivalenti: 0xFEDCBA9876543210 e l'elenco delimitato da virgole seguente di cifre esadecimali abbinate: FE, DC, BA, 98, 76, 54, 32, 10.

• È possibile specificare un valore REG_DWORD in formato esadecimale (usando la notazione 0x) o in formato decimale.

• Un valore REG_SZ può essere espresso solo come stringa racchiusa tra virgolette doppie ("tra virgolette") o come %token strkey% definito nella sezione Stringhe INF di un file INF.

ValueRange
Usare la direttiva ValueRange se i valori delle impostazioni di risparmio energia consentiti possono essere definiti meglio come sequenza incrementata di valori interi non negativi all'interno di un intervallo specificato. Il risparmio energia verifica che un'impostazione selezionata da un utente in Opzioni di Risparmio energia in Pannello di controllo sia uno di questi valori consentiti. Il set di valori consentiti è determinato da un valore minimo consentito, da un valore massimo consentito e da un incremento tra i valori consentiti all'interno dell'intervallo. Un valore è consentito se soddisfa quanto segue:

range-minimum-value + k*range-increment

dove range-minimum-value è maggiore o uguale a zero, k e range-increment sono maggiori o uguali a uno e il valore è minore o uguale a range-maximum-value. Inoltre, range-maximum-value deve essere uguale a range-minimum-value-range-increment + * per alcuni k.

Ad esempio, per un valore minimo di intervallo uguale a 0, un valore massimo di intervallo uguale a 10 e un incremento di intervallo uguale a 2, i valori consentiti sono i seguenti: 0, 2, 4, 6, 8 e 10.

Se i valori delle impostazioni di risparmio energia consentiti possono essere descritti meglio come un elenco di valori, in cui ogni valore può avere un tipo di dati personalizzato specifico del valore, usare la direttiva Value anziché la direttiva ValueRange .

range-minimum-value
Valore di tipo REG_DWORD che specifica l'impostazione minima di alimentazione consentita.

range-maximum-value
Valore di tipo REG_DWORD che specifica il valore massimo consentito per l'impostazione dell'alimentazione. Il valore massimo deve essere maggiore o uguale a minimum-value e deve essere uguale a range-minimum-value + k*range-increment, per un numero intero k maggiore di zero.

incremento intervallo
Valore di tipo REG_DWORD maggiore di zero. Questo valore specifica la differenza tra valori consecutivi all'interno dell'intervallo inclusivo specificato da range-minimum-value e range-maximum-value.

range-unit-label
Stringa facoltativa che descrive il valore dell'impostazione dell'alimentazione. La stringa, insieme a setting-name, informa l'utente del tipo di dati da immettere.

Ad esempio, la stringa può essere usata per specificare le unità valore, ad esempio "minutes" o "%" (che rappresenta la percentuale).

Predefinita
Esistono sei direttive Predefinite che devono essere incluse in una sezione AddPowerSetting . Una direttiva Default specifica il valore predefinito per una delle tre personalità dello schema di alimentazione definito dal sistema che si applicano a uno stato di alimentazione AC e alle tre personalità dello schema di alimentazione definito dal sistema che si applicano a uno stato di alimentazione del controller di dominio.

È estremamente importante che le impostazioni predefinite siano valide e accurate. Se l'utente non imposta manualmente un'impostazione di risparmio energia, il risparmio energia usa il valore predefinito specificato dalla direttiva Default .

power-scheme-personality-GUID
Uno dei GUID seguenti, che identifica lo schema di alimentazione a cui si applica il valore predefinito.

Questi GUID sono definiti in Wdm.h.

AC/DC-index
Se AC/DC-index è 0, l'impostazione si applica a uno stato di alimentazione AC e se AC/DC-index è 1, l'impostazione si applica a uno stato di alimentazione del controller di dominio. Un valore diverso da 0 o 1 non è valido.

default-setting-index
Se la direttiva Value viene utilizzata per specificare i valori consentiti, default-setting-index è il valore della voce value-index della direttiva Value . Se la direttiva ValueRange viene utilizzata per specificare i valori consentiti, questa voce non si applica.

default-setting-value
Se la direttiva ValueRange viene utilizzata per specificare i valori consentiti, default-setting-value è uno dei valori consentiti specificati dalla direttiva ValueRange . Se la direttiva Value viene utilizzata per specificare i valori consentiti, questa voce non si applica.

Remarks

Un nome di add-power-setting-section deve essere univoco in un file INF, ma può essere fatto riferimento da più di una direttiva AddPowerSetting nello stesso file INF. Ogni nome di sezione deve seguire le regole generali descritte in Regole di sintassi generali per i file INF.

Il risparmio energia non rimuove automaticamente i criteri di risparmio energia del dispositivo dopo la disinstallazione di un dispositivo. L'installazione o la rimozione di impostazioni di alimentazione, valori e impostazioni predefinite possono essere eseguite da un co-programma di installazione tramite le routine di impostazione dell'alimentazione fornita dal sistema definite in Powrprof.h. Per altre informazioni su queste routine di risparmio energia, vedere le informazioni di riferimento sul risparmio energia fornite con la documentazione di Microsoft Windows SDK.

Inoltre, lo strumento da riga di comandoPowercfg.exepuò essere usato per modificare le impostazioni di risparmio energia. Per informazioni su Powercfg.exe, vedere la Guida e il Supporto tecnico di Microsoft.

Per altre informazioni su come usare le estensioni .nt, .ntx86, .ntia64, .ntamd64, ntarm e ntarm64 definite dal sistema, vedere Creazione di file INF per più piattaforme e sistemi operativi.

Specifica di un valore di voce della stringa AddPowerSetting

Ad eccezione delle voci value-data di tipo REG_SZ, tutti gli altri valori di voce stringa forniti con una direttiva AddPowerSetting possono essere espressi come stringa racchiusa tra virgolette doppie ("quoted-string"), come %strkey% token definito nella sezione stringa INF di un file INF o come valore del Registro di sistema indipendente dalla lingua.

I valori del Registro di sistema indipendenti dalla lingua vengono usati per supportare Windows MUI (Multilingual User Interface) e vengono specificati come segue:

"@file-path,-resourceID[;comment]"

Le voci che specificano un valore del Registro di sistema indipendente dalla lingua sono le seguenti:

percorso file
Percorso completo del file contenente la risorsa.

resourceID
ID risorsa della risorsa corrispondente. Nel caso di una stringa, resourceID fa riferimento a una stringa. Nel caso di un'icona, resourceID fa riferimento a un'icona.

Commento
Valore facoltativo che può essere usato per facilitare il debug o per fornire un commento aggiuntivo sull'impostazione. Nel caso di una risorsa stringa, power manager non combina o visualizza la stringa di commento con la stringa di risorsa specificata.

Per altre informazioni su come specificare i valori del Registro di sistema indipendente dalla lingua, vedere Rendering Shell e Stringhe del Registro di sistema.

Esempi

I due esempi seguenti definiscono le impostazioni di alimentazione che controllano la luminosità di un LCD. Il primo esempio mostra come usare la direttiva Value per definire un valore minimo, medio e massimo di luminosità LCD.

// Within a DDinstall or ClassInstall23 section
AddPowerSetting=LCDDim
...

[LCDDim]
SubGroup = {7516B95F-F776-4464-8C53-06167F40CC99}
Setting = {381B4222-F694-41F0-9685-FF5BB260DF2E}, "LCD Brightness", "Controls the brightness of the LCD display"

Value = 0, "Low", "Minimum Brightness", %FLG_ADDREG_TYPE_DWORD%, 0x50
Value = 1, "Medium", "Medium Brightness", %FLG_ADDREG_TYPE_DWORD%, 0x75
Value = 2, "High", "Maximum Brightness", %FLG_ADDREG_TYPE_DWORD%, 0x100

Default = %GUID_MAX_POWER_SAVINGS%, %AC%, 0
Default = %GUID_MAX_POWER_SAVINGS%, %DC%, 0
Default = %GUID_TYPICAL_POWER_SAVINGS%, %AC%, 2
Default = %GUID_TYPICAL_POWER_SAVINGS%, %DC%, 1
Default = %GUID_MIN_POWER_SAVINGS%, %AC%, 2
Default = %GUID_MIN_POWER_SAVINGS%, %DC%, 2
...

[Strings]
GUID_MAX_POWER_SAVINGS = {a1841308-3541-4fab-bc81-f71556f20b4a}
GUID_TYPICAL_POWER_SAVINGS = {381b4222-f694-41f0-9685-ff5bb260df2e}
GUID_MIN_POWER_SAVINGS = {8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c}
AC = 0
DC = 1
FLG_ADDREG_TYPE_DWORD = 0x00010001

Il secondo esempio mostra come usare la direttiva ValueRange per definire un intervallo di valori di luminosità LCD consentiti che variano da 0% a 100%, con un incremento di 1% tra i valori consentiti.

// Within a DDinstall or a ClassInstall23 section
AddPowerSetting=LCDDimRange
...

[LCDDimRange]
SubGroup = {7516B95F-F776-4464-8C53-06167F40CC99}
Setting = {381B4222-F694-41F0-9685-FF5BB260DF2E}, "LCD Brightness", "Controls the brightness of the LCD display"
ValueRange = 0, 100, 1, "%"
Default = %GUID_MAX_POWER_SAVINGS%, %AC%, 50
Default = %GUID_MAX_POWER_SAVINGS%, %DC%, 50
Default = %GUID_TYPICAL_POWER_SAVINGS%, %AC%, 95
Default = %GUID_TYPICAL_POWER_SAVINGS%, %DC%, 50
Default = %GUID_MIN_POWER_SAVINGS%, %AC%, 100
Default = %GUID_MIN_POWER_SAVINGS%, %DC%, 100

[Strings]
GUID_MAX_POWER_SAVINGS = {a1841308-3541-4fab-bc81-f71556f20b4a}
GUID_TYPICAL_POWER_SAVINGS = {381b4222-f694-41f0-9685-ff5bb260df2e}
GUID_MIN_POWER_SAVINGS = {8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c}
AC = 0
DC = 1

Vedere anche

ClassInstall32

DDInstall

DDInstall. CoInstaller

DDInstall. HW

DDInstall. Interfacce

DDInstall. Servizi