DEVPKEY_DrvPkg_Icon
La proprietà del dispositivo DEVPKEY_DrvPkg_Icon rappresenta un elenco di icone del dispositivo usate da Windows per rappresentare visivamente un'istanza del dispositivo.
| Attributo | Valore |
|---|---|
| Chiave della proprietà | DEVPKEY_DrvPkg_Icon |
| Identificatore property-data-type | DEVPROP_TYPE_STRING_LIST |
| Accesso a proprietà | Accesso in sola lettura da applicazioni di installazione e programmi di installazione |
| Localizzata | Sì |
Commenti
Ogni icona nell'elenco viene specificata da un percorso di un file icona (*.ico) o da un riferimento a una risorsa icona in un file eseguibile.
La prima icona nell'elenco viene usata come impostazione predefinita. È possibile specificare icone aggiuntive che forniscono rappresentazioni visive diverse di un dispositivo. Windows include un'interfaccia utente che consente a un utente di selezionare l'icona visualizzata da Windows. Ad esempio, Microsoft DiscoveryCam 530 è disponibile in blu, verde e rosso. Microsoft fornisce un'icona per ogni colore. Windows usa l'icona blu per impostazione predefinita perché è la prima nell'elenco. Tuttavia, gli utenti di Windows possono anche scegliere l'icona verde o l'icona rossa.
L'elenco di icone è un elenco delimitato da NULL di identificatori di icone. Un identificatore di icona è un percorso di un file icona (*.ico) o un identificatore di risorsa icona, come indicato di seguito:
Il formato del percorso di un file icona è DirectoryPath\filename.ico.
Un identificatore di risorsa icona include le voci seguenti:
@executable-file-path,resource-identifierIl primo carattere dell'identificatore di risorsa icona è il simbolo (@) seguito dal percorso di un file eseguibile ( un file *.exe o un file *.dll ), seguito da un separatore di virgole (,) e quindi dalla voce dell'identificatore di risorsa .
Ad esempio, l'identificatore di icona"@shell32.dll,-30" rappresenta il file eseguibile "shell32.dll" e l'identificatore di risorsa "-30".
Un identificatore di risorsa deve essere un valore intero, che corrisponde a una risorsa all'interno del file eseguibile, come indicato di seguito:
Se l'identificatore specificato è negativo, Windows usa la risorsa nel file eseguibile il cui identificatore è uguale al valore assoluto dell'identificatore fornito.
Se l'identificatore specificato è zero, Windows usa la risorsa nel file eseguibile il cui identificatore ha il valore più basso nel file eseguibile.
Se l'identificatore specificato è positivo, ad esempio il valore n, Windows usa la risorsa nel file eseguibile il cui identificatore è il valore più basso n+1 nel file eseguibile. Ad esempio, se il valore di n è 1, Windows usa la risorsa il cui identificatore ha il secondo valore più basso nel file eseguibile.
È possibile impostare il valore di DEVPKEY_DrvPkg_Icon da una direttiva INF AddProperty inclusa nella sezione INF DDInstall del file INF che installa il dispositivo. È possibile recuperare il valore di DEVPKEY_DrvPkg_Icon chiamando CM_Get_DevNode_Property o SetupDiGetDeviceProperty.
Di seguito è riportato un esempio di come usare una direttiva INF AddProperty per impostare DEVPKEY_DrvPkg_Icon per un dispositivo installato da una sezione INF DDInstall "SampleDDInstallSection":
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Requisiti
Versione: Windows Vista e versioni successive di Windows
Intestazione: Devpkey.h (include Devpkey.h)