DEVPKEY_DrvPkg_Icon
A propriedade DEVPKEY_DrvPkg_Icon dispositivo representa uma lista de ícones de dispositivo que o Windows usa para representar visualmente uma instância do dispositivo.
| Atributo | Valor |
|---|---|
| Chave de propriedade | DEVPKEY_DrvPkg_Icon |
| Identificador de tipo de dados de propriedade | DEVPROP_TYPE_STRING_LIST |
| Acesso à propriedade | Acesso somente leitura por aplicativos de instalação e instaladores |
| Localizada | Sim |
Comentários
Cada ícone na lista é especificado por um caminho de um arquivo de ícone (*.ico) ou uma referência a um recurso de ícone em um arquivo executável.
O primeiro ícone na lista é usado como padrão. Ícones adicionais podem ser fornecidos que fornecem diferentes representações visuais de um dispositivo. O Windows inclui uma interface do usuário que permite que um usuário selecione qual ícone o Windows exibe. Por exemplo, o Microsoft DiscoveryCam 530 está disponível em azul, verde e vermelho. A Microsoft fornece um ícone para cada cor. O Windows usa o ícone azul por padrão porque é o primeiro da lista. No entanto, os usuários do Windows também podem escolher o ícone verde ou o ícone vermelho.
A lista de ícones é uma lista separada por NULL de especificadores de ícone. Um especificador de ícone é um caminho de um arquivo de ícone (*.ico) ou um especificador de ícone-recurso, da seguinte maneira:
O formato do caminho para um arquivo de ícone é DirectoryPath\filename.ico.
Um especificador de recurso de ícone tem as seguintes entradas:
@executable-file-path,resource-identifierO primeiro caractere do especificador icon-resource é o sinal (@) seguido pelo caminho de um arquivo executável (um *.exe ou um arquivo *.dll ), seguido por um separador de vírgulas (,) e, em seguida, a entrada do identificador de recurso .
Por exemplo, o especificador de ícone "@shell32.dll,-30" representa o arquivo executável "shell32.dll" e o identificador de recurso "-30".
Um identificador de recurso deve ser um valor inteiro, que corresponde a um recurso dentro do arquivo executável, da seguinte maneira:
Se o identificador fornecido for negativo, o Windows usará o recurso no arquivo executável cujo identificador é igual ao valor absoluto do identificador fornecido.
Se o identificador fornecido for zero, o Windows usará o recurso no arquivo executável cujo identificador tem o menor valor no arquivo executável.
Se o identificador fornecido for positivo, por exemplo, o valor n, o Windows usará o recurso no arquivo executável cujo identificador é o valor mais baixo n+1 no arquivo executável. Por exemplo, se o valor de n for 1, o Windows usará o recurso cujo identificador tem o segundo valor mais baixo no arquivo executável.
Você pode definir o valor de DEVPKEY_DrvPkg_Icon por uma diretiva AddProperty do INF incluída na seção INF DDInstall do arquivo INF que instala o dispositivo. Você pode recuperar o valor de DEVPKEY_DrvPkg_Icon chamando CM_Get_DevNode_Property ou SetupDiGetDeviceProperty.
Veja a seguir um exemplo de como usar uma diretiva AddProperty do INF para definir DEVPKEY_DrvPkg_Icon para um dispositivo instalado por uma seção INF DDInstall "SampleDDInstallSection":
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Requisitos
Versão: Windows Vista e versões posteriores do Windows
Cabeçalho: Devpkey.h (inclua Devpkey.h)