DEVPKEY_DrvPkg_Icon デバイス プロパティは、デバイス インスタンスを視覚的に表すために使用Windowsデバイス アイコンの一覧を表します。
| Attribute | 値 |
|---|---|
| プロパティキー | DEVPKEY_DrvPkg_Icon |
| Property-data-type 識別子 | DEVPROP_TYPE_STRING_LIST |
| 「プロパティ アクセス」 | インストール アプリケーションとインストーラーによる読み取り専用アクセス |
| ローカライズ済み | Yes |
Remarks
リスト内の各アイコンは、アイコン ファイル (*.ico) のパスまたは実行可能ファイル内のアイコン リソースへの参照によって指定されます。
リストの最初のアイコンが既定として使用されます。 デバイスのさまざまな視覚的表現を提供する追加のアイコンを指定できます。 Windowsには、ユーザーが表示するアイコンWindows選択できるユーザー インターフェイスが含まれています。 たとえば、Microsoft DiscoveryCam 530 は青、緑、赤で使用できます。 Microsoftは、色ごとにアイコンを提供します。 Windowsは、一覧の最初のアイコンであるため、既定で青色のアイコンを使用します。 ただし、Windowsユーザーは、緑色のアイコンまたは赤いアイコンを選択することもできます。
アイコンリストは、アイコン指定子の NULL で区切られたリストです。 アイコン指定子は、次のように、アイコン ファイル (*.ico) またはアイコン リソース指定子のパスです。
アイコン ファイルへのパスの形式は DirectoryPath\filename.ico です。
アイコン リソース指定子には、次のエントリがあります。
@executable-file-path,resource-identifierアイコン リソース指定子の最初の文字は、アット マーク (@) の後に実行可能ファイル ( *.exe または *.dll ファイル) のパスが続き、コンマ区切り記号 (,)、リソース 識別子 エントリが続きます。
たとえば、アイコン指定子"@shell32.dll,-30" は、実行可能ファイル "shell32.dll" とリソース識別子 "-30" を表します。
リソース識別子は、次のように、実行可能ファイル内のリソースに対応する整数値である必要があります。
指定された識別子が負の値の場合、Windowsは、指定された識別子の絶対値と等しい識別子を持つ実行可能ファイル内のリソースを使用します。
指定された識別子が 0 の場合、Windowsは実行可能ファイル内のリソースを使用し、その識別子は実行可能ファイルの中で最も小さい値を持ちます。
指定された識別子が正の値 (たとえば、値 n) の場合、Windowsは実行可能ファイル内の最も低い値が n+1 の識別子を持つ実行可能ファイル内のリソースを使用します。 たとえば、n の値が 1 の場合、Windowsは実行可能ファイルで 2 番目に小さい値を持つ識別子を持つリソースを使用します。
デバイスをインストールする 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"
...
Requirements
バージョン: Windows Vista以降のバージョンのWindows
ヘッダー: Devpkey.h (Devpkey.h を含む)