DEVPKEY_DrvPkg_Icon
La propiedad DEVPKEY_DrvPkg_Icon dispositivo representa una lista de iconos de dispositivo que Windows usa para representar visualmente una instancia de dispositivo.
| Atributo | Value |
|---|---|
| Clave de propiedad | DEVPKEY_DrvPkg_Icon |
| Identificador de tipo de datos de propiedad | DEVPROP_TYPE_STRING_LIST |
| Property Access | Acceso de solo lectura mediante aplicaciones de instalación e instaladores |
| Localizada | Sí |
Observaciones
Cada icono de la lista se especifica mediante una ruta de acceso de un archivo de icono (*.ico) o una referencia a un recurso de icono en un archivo ejecutable.
El primer icono de la lista se usa como valor predeterminado. Se pueden proporcionar iconos adicionales que proporcionan diferentes representaciones visuales de un dispositivo. Windows incluye una interfaz de usuario que permite a un usuario seleccionar qué icono muestra Windows. Por ejemplo, Microsoft DiscoveryCam 530 está disponible en azul, verde y rojo. Microsoft proporciona un icono para cada color. Windows usa el icono azul de forma predeterminada porque es el primero de la lista. Sin embargo, los usuarios de Windows también pueden elegir el icono verde o el icono rojo.
La lista de iconos es una lista separada por NULL de especificadores de iconos. Un especificador de iconos es una ruta de acceso de un archivo de icono (*.ico) o un especificador icon-resource, como se indica a continuación:
El formato de la ruta de acceso a un archivo de icono es DirectoryPath\filename.ico.
Un especificador icon-resource tiene las siguientes entradas:
@executable-file-path,resource-identifierEl primer carácter del especificador de recursos de icono es el signo (@) seguido de la ruta de acceso de un archivo ejecutable ( un *.exe o un archivo *.dll ), seguido de un separador de comas (,) y, a continuación, la entrada de identificador de recurso .
Por ejemplo, el especificador de iconos"@shell32.dll,-30" representa el archivo ejecutable "shell32.dll" y el identificador de recurso "-30".
Un identificador de recurso debe ser un valor entero, que corresponde a un recurso dentro del archivo ejecutable, como se indica a continuación:
Si el identificador proporcionado es negativo, Windows usa el recurso en el archivo ejecutable cuyo identificador es igual al valor absoluto del identificador proporcionado.
Si el identificador proporcionado es cero, Windows usa el recurso en el archivo ejecutable cuyo identificador tiene el valor más bajo en el archivo ejecutable.
Si el identificador proporcionado es positivo, por ejemplo, el valor n, Windows usa el recurso en el archivo ejecutable cuyo identificador es el valor n+1 más bajo del archivo ejecutable. Por ejemplo, si el valor de n es 1, Windows usa el recurso cuyo identificador tiene el segundo valor más bajo en el archivo ejecutable.
Puede establecer el valor de DEVPKEY_DrvPkg_Icon mediante una directiva AddProperty INF que se incluye en la sección INF DDInstall del archivo INF que instala el dispositivo. Puede recuperar el valor de DEVPKEY_DrvPkg_Icon llamando a CM_Get_DevNode_Property o SetupDiGetDeviceProperty.
A continuación se muestra un ejemplo de cómo usar una directiva AddProperty INF para establecer DEVPKEY_DrvPkg_Icon para un dispositivo instalado por una sección de DDInstall inf "SampleDDInstallSection":
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Requisitos
Versión: Windows Vista y versiones posteriores de Windows
Encabezado: Devpkey.h (incluya Devpkey.h)