DEVPKEY_DrvPkg_Icon 디바이스 속성은 Windows 디바이스 인스턴스를 시각적으로 나타내는 데 사용하는 디바이스 아이콘 목록을 나타냅니다.
| Attribute | Value |
|---|---|
| 속성 키 | DEVPKEY_DrvPkg_Icon |
| 속성 데이터 형식 식별자 | 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아이콘 리소스 지정자의 첫 번째 문자는 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"
...
Requirements
버전: Windows Vista 이상 버전의 Windows
헤더: Devpkey.h(Devpkey.h 포함)