DEVPKEY_DrvPkg_Icon
DEVPKEY_DrvPkg_Icon 디바이스 속성은 Windows가 디바이스 instance 시각적으로 나타내는 데 사용하는 디바이스 아이콘 목록을 나타냅니다.
| attribute | 값 |
|---|---|
| 속성 키 | DEVPKEY_DrvPkg_Icon |
| Property-data-type 식별자 | DEVPROP_TYPE_STRING_LIST |
| 속성 액세스 | 설치 애플리케이션 및 설치 관리자별 읽기 전용 액세스 |
| 지역화 된 | Yes |
설명
목록의 각 아이콘은 아이콘 파일의 경로(*.ico) 또는 실행 파일의 아이콘 리소스에 대한 참조로 지정됩니다.
목록의 첫 번째 아이콘이 기본값으로 사용됩니다. 디바이스의 다양한 시각적 표현을 제공하는 추가 아이콘을 제공할 수 있습니다. Windows에는 사용자가 Windows가 표시하는 아이콘을 선택할 수 있는 사용자 인터페이스가 포함되어 있습니다. 예를 들어 Microsoft DiscoveryCam 530은 파란색, 녹색 및 빨간색으로 제공됩니다. Microsoft는 각 색에 대한 아이콘을 제공합니다. Windows는 목록의 첫 번째 아이콘이므로 기본적으로 파란색 아이콘을 사용합니다. 그러나 Windows 사용자는 녹색 아이콘 또는 빨간색 아이콘을 선택할 수도 있습니다.
아이콘 목록은 NULL로 구분된 아이콘 지정자 목록입니다. 아이콘 지정자는 다음과 같이 아이콘 파일(*.ico) 또는 icon-resource 지정자의 경로입니다.
아이콘 파일 경로의 형식은 DirectoryPath\filename.ico입니다.
icon-resource 지정자에는 다음 항목이 있습니다.
@executable-file-path,resource-identifiericon-resource 지정자의 첫 번째 문자는 at sign(@) 뒤에 실행 파일의 경로( *.exe 또는 *.dll 파일) 뒤에 쉼표 구분 기호(,) 및 리소스 식별자 항목이 뒤따릅니다.
예를 들어 아이콘 지정자"@shell32.dll,-30"은 실행 파일 "shell32.dll"과 리소스 식별자 "-30"을 나타냅니다.
리소스 식별자는 다음과 같이 실행 파일 내의 리소스에 해당하는 정수 값이어야 합니다.
제공된 식별자가 음수이면 Windows는 식별자가 제공된 식별자의 절대 값과 같은 실행 파일의 리소스를 사용합니다.
제공된 식별자가 0이면 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 포함)