DEVPKEY_DrvPkg_Icon
DEVPKEY_DrvPkg_Icon裝置屬性代表 Windows 用來以視覺方式表示裝置實例的裝置圖示清單。
| 屬性 | 值 |
|---|---|
| 屬性索引鍵 | DEVPKEY_DrvPkg_Icon |
| Property-data-type 識別碼 | DEVPROP_TYPE_STRING_LIST |
| 屬性存取 | 安裝應用程式和安裝程式的唯讀存取 |
| 當地語系化 | 是 |
備註
清單中的每個圖示都是由圖示檔案的路徑指定， (*.ico) 或可執行檔中圖示資源的參考。
清單中的第一個圖示會當做預設值使用。 您可以提供其他圖示，以提供不同的裝置視覺標記法。 Windows 包含使用者介面，可讓使用者選取 Windows 顯示的圖示。 例如，Microsoft DiscoveryCam 530 以藍色、綠色和紅色提供。 Microsoft 會為每個色彩提供圖示。 Windows 預設會使用藍色圖示，因為它是清單中的第一個圖示。 不過，Windows 使用者可以選擇綠色圖示或紅色圖示。
圖示清單是以 Null 分隔的圖示規範清單。 圖示規範是圖示檔案的路徑， (*.ico) 或圖示資源規範，如下所示：
圖示檔的路徑格式為 DirectoryPath\filename.ico。
圖示資源規範具有下列專案：
@executable-file-path,resource-identifier圖示資源規範的第一個字元是 at 符號 (@) 後面接著可執行檔的路徑 (*.exe 或 *.dll 檔案) ，後面接著逗號分隔符號 (，) ，然後 是資源識別碼 專案。
例如，圖示規範「@shell32.dll，-30」 代表可執行檔 「shell32.dll」 和資源識別碼 「-30」。
資源識別碼必須是整數值，其對應至可執行檔內的資源，如下所示：
如果提供的識別碼為負數，Windows 會使用可執行檔中的資源，其識別碼等於所提供識別碼的絕對值。
如果提供的識別碼為零，Windows 會使用可執行檔中的資源，其識別碼在可執行檔中具有最低值。
例如，如果提供的識別碼是正數，則值 n，Windows 會使用可執行檔中的資源，其識別碼是可執行檔中的 n+1 最低值。 例如，如果 n 的值是 1，Windows 會使用識別碼在可執行檔中具有第二個最低值的資源。
您可以透過安裝裝置之INF 檔案的 INF DDInstall區段中所包含的INF AddProperty 指示詞，設定DEVPKEY_DrvPkg_Icon的值。 您可以呼叫 CM_Get_DevNode_Property 或SetupDiGetDeviceProperty來擷取DEVPKEY_DrvPkg_Icon的值。
下列範例示範如何使用 INF AddProperty 指示詞為 INF DDInstall 區段 「SampleDDInstallSection 」 所安裝的裝置設定DEVPKEY_DrvPkg_Icon：
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
規格需求
版本：Windows Vista 和更新版本的 Windows
標頭：Devpkey.h (包含 Devpkey.h)