Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une directive AddPowerSetting fait référence à une ou plusieurs sections utilisées pour modifier ou créer des informations de paramètre d’alimentation. Chaque section add-power-setting-section définit un paramètre d’alimentation, les valeurs autorisées pour le paramètre d’alimentation, le nom convivial du paramètre d’alimentation et la description du paramètre d’alimentation. Une section add-power-setting-section spécifie également la valeur par défaut pour chaque personnalité de schéma d’alimentation. Pour plus d’informations sur les paramètres d’alimentation et les personnalités du schéma d’alimentation, consultez Gestion des états des performances des appareils.
[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]
En général, une section add-power-setting-section inclut les directives suivantes :
Directive SubGroup .
Directive Paramètre
Liste de deux directives Value ou plus ou d’une directive ValueRange .
Ensemble de six directives par défaut .
Une section add-power-setting-section prend l’une des deux formes possibles suivantes :
Si les valeurs de paramètres d’alimentation autorisées peuvent être définies comme un ensemble de deux valeurs ou plus discrètes, utilisez une liste de directives Valeur pour spécifier les valeurs autorisées, comme suit :
[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 ...Si les valeurs de paramètres d’alimentation autorisées peuvent être définies comme une séquence incrémentée de valeurs entières non négatives dans une plage spécifiée, utilisez une directive ValueRange pour spécifier des valeurs autorisées, comme suit :
[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 ...
Entrées
Remarque
À l’exception d’une entrée de données de valeur , toutes les entrées suivantes qui fournissent une valeur de chaîne peuvent spécifier la chaîne de l’une des façons décrites dans Spécifier une valeur d’entrée de chaîne AddPowerSetting.
Sous-groupe
Un sous-groupe regroupe les paramètres d’alimentation liés logiquement.
Pour spécifier un sous-groupe défini par le système, incluez une directive SubGroup et fournissez uniquement l’entrée sous-groupe-guid . Les sous-groupes définis par le système sont représentés par les constantes GUID_Xxx_SUBGROUP et NO_SUBGROUP_GUID, qui sont définies dans Wdm.h.
Par exemple, GUID_VIDEO_SUBGROUP représente le sous-groupe qui contient les paramètres d’alimentation vidéo d’une personnalité de schéma d’alimentation. La constante NO_SUBGROUP_GUID représente une collection de paramètres qui n’appartiennent logiquement à aucun sous-groupe. Si une directive SubGroup n’est pas incluse, le paramètre est ajouté par défaut à la collection de paramètres qui n’appartiennent logiquement à aucun sous-groupe.
Pour définir un nouveau sous-groupe, incluez la directive SubGroup et fournissez les entrées requises suivantes : sous-groupe-guid, sous-groupe-name, sous-groupe-description et sous-groupe-icône. Le GUID du nouveau sous-groupe doit être unique et les autres entrées doivent être aussi descriptives que possible.
sous-groupe-guid
L’entrée requise fournit le GUID qui identifie le sous-groupe. Le format de cette entrée est {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, où « X » est un chiffre hexadécimal.
Par exemple, la valeur de la constante définie par le système GUID_VIDEO_SUBGROUP est {7516B95F-F776-4464-8C53-06167F40CC99}. Ce GUID représente le sous-groupe qui contient les paramètres d’alimentation vidéo d’une personnalité de schéma d’alimentation.
nom du sous-groupe
Chaîne qui spécifie le nom du sous-groupe du paramètre d’alimentation. Si le sous-groupe est un sous-groupe défini par le système, cette entrée ne doit pas être fournie. Si le sous-groupe est nouveau, cette entrée est requise.
sous-groupe-description
Chaîne qui décrit à l’utilisateur le sous-groupe d’alimentation. Si le sous-groupe est un sous-groupe défini par le système, cette entrée ne doit pas être fournie. Si le sous-groupe est nouveau, cette entrée est requise.
sous-groupe-icône
Référence à une ressource d’icône. Si le sous-groupe est un sous-groupe défini par le système, cette entrée ne doit pas être fournie. Si le sous-groupe est nouveau, cette entrée est requise.
Une ressource d’icône doit être spécifiée en tant que valeur de Registre neutre en langage. Pour plus d’informations sur la façon de spécifier une valeur de Registre neutre en langage, consultez Spécification d’une valeur d’entrée de chaîne AddPowerSetting.
Setting
La directive Paramètre identifie le paramètre auquel toutes les autres entrées de la section s’appliquent. Une directive paramètre est requise dans une section de paramètre d’ajout et il ne peut y avoir qu’une seule directive paramètre dans une section de paramètre de complément. Si un fichier INF définit plusieurs paramètres, chaque paramètre doit être défini dans sa propre section add-power-setting.
Voici les entrées associées à une directive Setting .
setting-guid
Entrée obligatoire qui spécifie le GUID qui représente le paramètre d’alimentation. Le format de cette entrée est {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}, où chaque « X » est un chiffre hexadécimal.
Par exemple, voici une valeur GUID personnalisée : {BFC0D9E9-549C-483D-AD2A-3D90C98A8B03}.
setting-name
Entrée facultative qui spécifie une chaîne qui contient le nom convivial du paramètre d’alimentation.
Les options d’alimentation dans Panneau de configuration affichent ce nom convivial à un utilisateur.
setting-description
Entrée facultative qui spécifie une chaîne qui décrit à l’utilisateur le paramètre d’alimentation et l’effet que le paramètre a sur l’alimentation et les performances du système.
icône setting-icon
Entrée facultative faisant référence à une ressource d’icône. Une ressource d’icône doit être spécifiée par une valeur de Registre neutre en langage.
Pour plus d’informations sur la façon de spécifier une valeur de registre neutre en langage, consultez Spécification d’une valeur d’entrée de chaîne AddPowerSetting.
Valeur
Une directive Valeur définit une valeur autorisée pour un paramètre d’alimentation. La directive Valeur doit être utilisée si les valeurs peuvent être définies au mieux en tant qu’ensemble de deux valeurs ou plus, où chaque valeur peut avoir un type de données personnalisé spécifique à une valeur. Dans ce cas, une section add-power-setting-section doit inclure deux directives Valeur ou plus. Un utilisateur peut sélectionner l’une de ces valeurs dans Options d’alimentation dans Panneau de configuration pour configurer un schéma d’alimentation.
Si les valeurs de paramètre d’alimentation autorisées peuvent être décrites comme un ensemble incrémenté d’entiers non négatifs dans une plage, utilisez la directive ValueRange au lieu de la directive Value pour spécifier les valeurs de paramètre d’alimentation autorisées.
value-index
Entrée obligatoire qui spécifie une valeur d’index unique, supérieure ou égale à zéro, et utilisée pour référencer la valeur de paramètre correspondante.
Les options d’alimentation dans Panneau de configuration affichent des valeurs de paramètre d’alimentation pour un utilisateur dans l’ordre de leurs valeurs d’index correspondantes, du plus bas au plus élevé.
value-name
Entrée requise qui fournit une chaîne qui fournit le nom convivial de la valeur de paramètre correspondante.
Les options d’alimentation dans Panneau de configuration affichent les noms conviviaux des valeurs de paramètre d’alimentation pour un utilisateur.
value-description
Entrée facultative qui fournit une chaîne qui décrit à l’utilisateur la valeur du paramètre d’alimentation et l’effet que la valeur de paramètre a sur l’alimentation et les performances du système.
value-flags
Entrée obligatoire qui spécifie le type de données de l’entrée de données valeur correspondante, comme indiqué dans le tableau suivant.
| Valeur de repère | Type de données |
|---|---|
| 0x00000001 | REG_BINARY |
| 0x00010001 | REG_DWORD |
| 0x00000000 | REG_SZ |
value-data
Entrée obligatoire qui fournit les données de la valeur de paramètre correspondante, dont le format dépend du type de données spécifié par l’entrée d’indicateurs de valeur correspondante, comme suit :
Une valeur REG_BINARY peut être spécifiée au format hexadécimal à l’aide de la notation 0x ou en tant que liste séparée par des virgules de nombres hexadécimaux jumelés sans notation 0x.
Par exemple, les entrées suivantes sont équivalentes : 0xFEDCBA9876543210 et la liste séparée par des virgules suivantes de chiffres hexadécimaux jumelés : FE, DC, BA, 98, 76, 54, 32, 10.
Une valeur REG_DWORD peut être spécifiée au format hexadécimal (à l’aide de la notation 0x) ou au format décimal.
Une valeur REG_SZ ne peut être exprimée qu’en tant que chaîne entre guillemets doubles (« entre guillemets ») ou en tant que jeton% %% clé définie dans la section Chaînes INF d’un fichier INF.
Remarque
Vous ne devez pas utiliser de valeurs de chaîne, car elles ne peuvent pas être localisées. Utilisez plutôt des valeurs de type REG_BINARY ou de REG_DWORD.
ValueRange
Utilisez la directive ValueRange si les valeurs autorisées des paramètres d’alimentation peuvent être définies comme une séquence incrémentée de valeurs entières non négatives dans une plage spécifiée. Power Manager valide qu’un paramètre sélectionné par un utilisateur dans Power Options dans Panneau de configuration est l’une de ces valeurs autorisées. L’ensemble de valeurs autorisées est déterminé par une valeur minimale autorisée, une valeur maximale autorisée et un incrément entre les valeurs autorisées dans la plage. Une valeur est autorisée s’il satisfait aux éléments suivants :
range-minimum-value + k*range-increment
où la valeur minimale de plage est supérieure ou égale à zéro, k et l’incrément de plage sont supérieures ou égales à une, et la valeur est inférieure ou égale à la valeur maximale de plage. En outre, la valeur maximale de la plage doit être égale à l’incrément deplagek de valeur + * minimale pour un certain k.
Par exemple, pour une valeur minimale de plage égale à 0, une valeur de plage maximale égale à 10 et un incrément de plage égal à 2, les valeurs autorisées sont les suivantes : 0, 2, 4, 6, 8 et 10.
Si les valeurs de paramètre d’alimentation autorisées peuvent être décrites comme une liste de valeurs, où chaque valeur peut avoir un type de données personnalisé spécifique à une valeur, utilisez la directive Value au lieu de la directive ValueRange .
range-minimum-value
Valeur de type REG_DWORD qui spécifie le paramètre d’alimentation minimal autorisé.
range-maximum-value
Valeur de type REG_DWORD qui spécifie la valeur maximale autorisée du paramètre d’alimentation. La valeur maximale doit être supérieure ou égale à la valeur minimale et doit être égale à la valeur minimale de la plage + k*range-increment, pour un nombre entier k supérieur à zéro.
incrémentation de plage
Valeur de type REG_DWORD supérieure à zéro. Cette valeur spécifie la différence entre les valeurs consécutives dans la plage inclusive spécifiée par la valeur minimale de plage et la valeur maximale de plage.
range-unit-label
Chaîne facultative qui décrit la valeur de paramètre d’alimentation. La chaîne, ainsi que le nom de paramètre, informe l’utilisateur du type de données à entrer.
Par exemple, la chaîne peut être utilisée pour spécifier les unités de valeur, telles que « minutes » ou «%» (représentant le pourcentage).
Par défaut
Il existe six directives par défaut qui doivent être incluses dans une section AddPowerSetting . Une directive par défaut spécifie la valeur par défaut pour l’une des trois personnalités de schéma d’alimentation définies par le système qui s’appliquent à un état d’alimentation AC et les trois personnalités de schéma d’alimentation définies par le système qui s’appliquent à un état d’alimentation dc.
Il est extrêmement important que les valeurs par défaut soient valides et précises. Si l’utilisateur ne définit pas manuellement un paramètre d’alimentation, power manager utilise la valeur par défaut spécifiée par la directive Par défaut .
power-scheme-personality-GUID
L’un des GUID suivants, qui identifie le schéma d’alimentation auquel la valeur par défaut s’applique.
| Personnalité | GUID |
|---|---|
| Économiseur d’énergie | {A1841308-3541-4FAB-BC81-F71556F20B4A} |
| Hautes performances | {8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C} |
| Équilibrée | {381B4222-F694-41F0-9685-FF5BB260DF2E} |
Ces GUID sont définis dans Wdm.h.
AC/DC-index
Si AC/DC-index est 0, le paramètre s’applique à un état d’alimentation ac et si AC/DC-index est 1, le paramètre s’applique à un état d’alimentation dc. Une valeur autre que 0 ou 1 n’est pas valide.
default-setting-index
Si la directive Valeur est utilisée pour spécifier des valeurs autorisées, default-setting-index est la valeur de l’entrée value-index de la directive Value . Si la directive ValueRange est utilisée pour spécifier des valeurs autorisées, cette entrée ne s’applique pas.
default-setting-value
Si la directive ValueRange est utilisée pour spécifier des valeurs autorisées, la valeur de paramètre par défaut est l’une des valeurs autorisées spécifiées par la directive ValueRange . Si la directive Valeur est utilisée pour spécifier des valeurs autorisées, cette entrée ne s’applique pas.
Remarks
Un nom de section add-power-setting-section doit être unique dans un fichier INF, mais il peut être référencé par plusieurs directives AddPowerSetting dans le même fichier INF. Chaque nom de section doit respecter les règles générales décrites dans Règles de syntaxe générales pour les fichiers INF.
Power Manager ne supprime pas automatiquement les stratégies d’alimentation des appareils après la désinstallation d’un appareil. L’installation ou la suppression des paramètres d’alimentation, des valeurs et des valeurs par défaut peuvent être effectuées par un co-programme d’installation via les routines de paramètres d’alimentation fournies par le système définies dans Powrprof.h. Pour plus d’informations sur ces routines de gestion de l’alimentation, consultez la référence de gestion de l’alimentation fournie avec la documentation Microsoft Windows SDK.
En outre, l’outil en ligne de commande Powercfg.exe peut être utilisé pour modifier les paramètres d’alimentation. Pour plus d’informations sur Powercfg.exe, consultez le centre d’aide et de support Microsoft.
Pour plus d’informations sur l’utilisation des extensions .nt définies par le système, .ntx86, .ntia64, .ntamd64, .ntarm et .ntarm64, consultez Création de fichiers INF pour plusieurs plateformes et systèmes d’exploitation.
Spécification d’une valeur d’entrée de chaîne AddPowerSetting
À l’exception des entrées de données de type REG_SZ, toutes les autres valeurs d’entrée de chaîne fournies avec une directive AddPowerSetting peuvent être exprimées sous la forme d’une chaîne entre guillemets doubles (« guillemets-chaîne »), sous la forme d’un jeton% strkey %défini dans la section de chaîne INF d’un fichier INF, ou comme valeur de Registre neutre en langage.
Les valeurs de Registre neutres en langage sont utilisées pour prendre en charge Windows MUI (Multilingue User Interface) et sont spécifiées comme suit :
"@file-path,-resourceID[;comment]"
Les entrées qui spécifient une valeur de Registre neutre en langage sont les suivantes :
chemin d’accès au fichier
Chemin complet du fichier qui contient la ressource.
resourceID
ID de ressource de la ressource correspondante. Dans le cas d’une chaîne, resourceID fait référence à une chaîne. Dans le cas d’une icône, l’ID de ressource fait référence à une icône.
Commentaire
Valeur facultative qui peut être utilisée pour faciliter le débogage ou pour fournir un commentaire supplémentaire sur le paramètre. Dans le cas d’une ressource de chaîne, power Manager ne combine pas ou n’affiche pas la chaîne de commentaire avec la chaîne de ressource spécifiée.
Pour plus d’informations sur la façon de spécifier des valeurs de Registre neutres en langage, consultez Rendu Shell et Chaînes de Registre.
Examples
Les deux exemples suivants définissent les paramètres d’alimentation qui contrôlent la luminosité d’un écran LCD. Le premier exemple montre comment utiliser la directive Valeur pour définir une valeur minimale, moyenne et maximale de 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
Le deuxième exemple montre comment utiliser la directive ValueRange pour définir une plage de valeurs de luminosité LCD autorisées qui varient de 0% à 100%, avec un incrément de 1% entre les valeurs autorisées.
// 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