Identidade visual Painel de Controle com bitmaps ou ícones

No Windows XP e versões posteriores do Windows, o aplicativo de som no Painel de Controle dá suporte à identidade visual de terceiros de controles de dispositivo de áudio. Os IHVs (fornecedores independentes de hardware) podem exibir os seguintes itens ao lado dos controles de seus dispositivos de áudio:

• Logotipo da empresa

• Nome do dispositivo proprietário

O arquivo INF que instala o driver do dispositivo também carrega os dados de personalização Painel de Controle no registro. As imagens bitmadas dos logotipos da empresa estão contidas nos próprios arquivos de driver instalados.

No Windows XP, as informações de identidade visual são visíveis para os usuários nos seguintes locais do programa:

• A página Volume do aplicativo Sons e Dispositivos de Áudio em Painel de Controle (Mmsys.cpl)

• O programa SndVol32 (Sndvol32.exe)

No Windows Vista, as informações de identidade visual são visíveis para os usuários nas páginas Reprodução e Gravação do aplicativo Sound em Painel de Controle (Mmsys.cpl).

As informações de identidade visual são armazenadas no registro em uma subchave branding sob a chave raiz do dispositivo de áudio, que está localizada sob a chave de classe de mídia. A subchave Branding pode conter um ou mais dos valores de REG_SZ mostrados na tabela a seguir.

Nome do valor	Significado
ícone	Nome do arquivo que contém o ícone usado pelo menu de controle SndVol32.
bitmap	Nome do arquivo que contém o bitmap de 32 por 32 que é exibido na página Volume do aplicativo Dispositivos de Áudio e Som no Painel de Controle.

Esses valores são adicionados ao registro por diretivas na seção add-registry-section (consulte Diretiva AddReg inf) do arquivo INF que instala o driver de dispositivo. Painel de Controle usa padrões para todos os valores ausentes da subchave identidade visual.

O logotipo "bitmap" aparece à esquerda do nome do dispositivo proprietário na parte superior da página Volume . O logotipo "icon" aparece no canto superior esquerdo do menu de controle SndVol32.

O nome do dispositivo proprietário que aparece nas páginas mencionadas anteriormente é o nome amigável do dispositivo. Esse nome amigável é especificado por uma diretiva na seção add-registry do arquivo INF que instala o dispositivo. Essa diretiva contém o palavra-chave "FriendlyName", conforme mostrado no exemplo na Diretiva AddReg do INF. No Windows XP, a página Volume e o SndVol32 exibem apenas os primeiros 31 caracteres da cadeia de caracteres de nome. Cadeias de caracteres mais longas são truncadas. No Windows Vista e versões posteriores do Windows, essa restrição de 31 caracteres é removida quando o nome do dispositivo é exibido em Painel de Controle. Quando você usa APIs com suporte em versões do Windows anteriores ao Windows Vista, por exemplo , MCI_GetDevCaps, o limite de 31 caracteres ainda se aplica ao nome do dispositivo que você fornece à API.

Importante No Windows Vista e versões posteriores do Windows, não há mais suporte para o uso de imagens de bitmap para identidade visual de terceiros. Desenvolvedores de driver de áudio de terceiros que desejam marcar seus controles de dispositivo de áudio devem usar ícones. As dimensões de pixel com suporte para esses ícones são 32x32 ou 48x48.

Exemplo 1

O exemplo a seguir mostra algumas diretivas da seção add-registry do arquivo INF de um fornecedor:

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

Essas diretivas adicionam informações de identidade visual do painel de controle ao registro. O HKR representa a chave raiz do dispositivo de áudio no registro; a subchave De identidade visual é especificada em relação ao nome do caminho da chave raiz. O valor da cadeia de caracteres para o ícone ou a chave bitmap pode ser especificado em um dos dois formatos: "file,resourceid" ou "imagefile". A primeira diretiva no exemplo anterior usa o formato "file,resourceid". A diretiva atribui à chave de ícone um valor de cadeia de caracteres que contém um nome de arquivo, foo.sys e uma ID de recurso de 102. O nome do arquivo e a ID do recurso são separados por uma vírgula (sem espaços). O arquivo foo.sys contém o recurso de ícone. A segunda diretiva no exemplo anterior atribui uma cadeia de caracteres formatada "imagefile" à chave bitmap ; a cadeia de caracteres contém o nome do caminho completo de um arquivo .bmp que contém o bitmap.

A diretiva de exemplo para o valor do ícone pode ser alterada para usar o formato "imagefile", mas nesse caso o valor da cadeia de caracteres deve conter o nome do caminho de um arquivo com uma extensão de nome de arquivo .ico.

No caso do formato "file,resourceid", o software do painel de controle pesquisa a mesma lista dos caminhos de pesquisa que a função LoadLibrary (descrita na documentação do SDK do Microsoft Windows). Se essa lista de caminhos não contiver o arquivo, o software também pesquisa o diretório de drivers (consulte Seção DestinationDirs do INF). Esse formato permite que as imagens sejam facilmente armazenadas no próprio arquivo de driver sem exigir que nomes de caminho absolutos sejam especificados no arquivo INF.

Exemplo 2

O exemplo a seguir se aplica ao Windows Vista e versões posteriores do Windows. Este exemplo mostra uma diretiva da seção add-registry do arquivo INF de um fornecedor. Este exemplo usa o formato "imagefile":

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