Partager via

Panneau de configuration de personnalisation avec des bitmaps ou des icônes

  • Article

Dans Windows XP et les versions ultérieures de Windows, l’application audio dans Panneau de configuration prend en charge la personnalisation tierce des contrôles d’appareil audio. Les fournisseurs de matériel indépendants peuvent afficher les éléments suivants en regard des contrôles de leurs appareils audio :

  • Logo de la société

  • Nom de l’appareil propriétaire

Le fichier INF qui installe le pilote de périphérique charge également les données de personnalisation Panneau de configuration dans le Registre. Les images bitmap des logos d’entreprise sont contenues dans les fichiers de pilotes installés eux-mêmes.

Dans Windows XP, les informations de personnalisation sont visibles par les utilisateurs dans les emplacements de programme suivants :

  • Page Volume de l’application Sons et périphériques audio dans Panneau de configuration (Mmsys.cpl)

  • Le programme SndVol32 (Sndvol32.exe)

Dans Windows Vista, les informations de personnalisation sont visibles par les utilisateurs dans les pages Lecture et enregistrement de l’application Sound dans Panneau de configuration (Mmsys.cpl).

Les informations de personnalisation sont stockées dans le Registre dans une sous-clé Personnalisation sous la clé racine de l’appareil audio, qui se trouve sous la clé de classe multimédia. La sous-clé Branding peut contenir une ou plusieurs des valeurs REG_SZ indiquées dans le tableau suivant.

Nom de la valeur Signification

icon

Nom du fichier contenant l’icône utilisée par le menu de contrôle SndVol32.

bitmap

Nom du fichier qui contient l’image bitmap 32 par 32 qui s’affiche dans la page Volume de l’application Périphériques audio et audio dans Panneau de configuration.

Ces valeurs sont ajoutées au Registre par des directives au sein de la section add-registry (voir Directive AddReg INF) du fichier INF qui installe le pilote de périphérique. Panneau de configuration utilise les valeurs par défaut pour toutes les valeurs manquantes dans la sous-clé Branding.

Le logo « bitmap » apparaît à gauche du nom de l’appareil propriétaire en haut de la page Volume . Le logo « icône » s’affiche dans le coin supérieur gauche du menu de contrôle SndVol32.

Le nom d’appareil propriétaire qui apparaît dans les pages mentionnées précédemment est le nom convivial de l’appareil. Ce nom convivial est spécifié par une directive dans la section add-registry du fichier INF qui installe l’appareil. Cette directive contient le mot clé « FriendlyName », comme illustré dans l’exemple de directive AddReg INF. Dans Windows XP, la page Volume et SndVol32 affichent uniquement les 31 premiers caractères de la chaîne de nom. Les chaînes plus longues sont tronquées. Dans Windows Vista et les versions ultérieures de Windows, cette restriction de 31 caractères est supprimée lorsque le nom de l’appareil est affiché dans Panneau de configuration. Lorsque vous utilisez des API prises en charge dans des versions de Windows antérieures à Windows Vista, par exemple MCI_GetDevCaps, la limite de 31 caractères s’applique toujours au nom de l’appareil que vous fournissez à l’API.

Important Dans Windows Vista et les versions ultérieures de Windows, l’utilisation d’images bitmap pour la personnalisation tierce n’est plus prise en charge. Les développeurs de pilotes audio tiers qui souhaitent personnaliser leurs contrôles de périphérique audio doivent utiliser des icônes. Les dimensions de pixel prises en charge pour ces icônes sont 32x32 ou 48x48.

Exemple 1

L’exemple suivant montre quelques directives de la section add-registry du fichier INF d’un fournisseur :

  [XYZ-Audio-Device.AddReg]
  HKR,Branding,icon,,"foo.sys,102"
  HKR,Branding,bitmap,,"c:\mydir\myimage.bmp"

Ces directives ajoutent des informations de personnalisation du panneau de configuration au Registre. HKR représente la clé racine du périphérique audio dans le Registre ; la sous-clé Personnalisation est spécifiée par rapport au nom du chemin d’accès de la clé racine. La valeur de chaîne de l’icône ou de la clé bitmap peut être spécifiée dans l’un des deux formats suivants : « file, resourceid » ou « imagefile ». La première directive de l’exemple précédent utilise le format « file,resourceid ». La directive affecte à la clé d’icône une valeur de chaîne qui contient un nom de fichier, foo.sys et un ID de ressource de 102. Le nom de fichier et l’ID de ressource sont séparés par une virgule (sans espace). Le fichier foo.sys contient la ressource d’icône. La deuxième directive de l’exemple précédent affecte une chaîne au format « imagefile » à la clé bitmap ; la chaîne contient le nom complet du chemin d’accès d’un fichier .bmp qui contient l’image bitmap.

L’exemple de directive pour la valeur de l’icône peut être modifié pour utiliser le format « imagefile », mais dans ce cas, la valeur de chaîne doit contenir le nom de chemin d’accès d’un fichier avec une extension de nom de fichier .ico.

Dans le cas du format « file,resourceid », le logiciel du panneau de configuration recherche la même liste des chemins de recherche que la fonction LoadLibrary (décrite dans la documentation Microsoft Windows SDK). Si cette liste de chemins ne contient pas le fichier, le logiciel recherche également le répertoire des pilotes (voir la section INF DestinationDirs). Ce format permet aux images d’être facilement stockées dans le fichier de pilote lui-même sans exiger que les noms de chemin d’accès absolus soient spécifiés dans le fichier INF.

Exemple 2

L’exemple suivant s’applique à Windows Vista et aux versions ultérieures de Windows. Cet exemple montre une directive de la section add-registry du fichier INF d’un fournisseur. Cet exemple utilise le format « imagefile » :

[ABC-Audio-Device.AddReg]
  HKR,Branding,icon,,"c:\mydir\myicon.ico"