SetupDiLoadDeviceIcon 함수(setupapi.h)

SetupDiLoadDeviceIcon 함수는 지정된 디바이스의 아이콘을 검색합니다.

구문

WINSETUPAPI BOOL SetupDiLoadDeviceIcon(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  PSP_DEVINFO_DATA DeviceInfoData,
  [in]  UINT             cxIcon,
  [in]  UINT             cyIcon,
  [in]  DWORD            Flags,
  [out] HICON            *hIcon
);

매개 변수

[in] DeviceInfoSet

아이콘을 검색할 디바이스를 나타내는 디바이스 정보 요소가 포함된 디바이스 정보 집합 에 대한 핸들입니다.

[in] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.

[in] cxIcon

검색할 아이콘의 너비(픽셀)입니다. 시스템 메트릭 인덱스 SM_CXICON 사용하여 기본 크기 아이콘을 지정하거나 시스템 메트릭 인덱스 SM_CXSMICON 사용하여 작은 아이콘을 지정합니다. 시스템 메트릭 인덱스는 Winuser.h에 정의되며 GetSystemMetrics 함수를 호출하여 연결된 값을 검색할 수 있습니다. GetSystemMetrics 함수는 Microsoft Windows SDK 문서화되어 있습니다.

[in] cyIcon

검색할 아이콘의 높이(픽셀)입니다. SM_CXICON 사용하여 기본 크기 아이콘을 지정하거나 SM_CXSMICON 사용하여 작은 아이콘을 지정합니다.

[in] Flags

사용되지 않습니다. 를 0으로 설정해야 합니다.

[out] hIcon

이 함수가 검색하는 아이콘에 대한 핸들을 받는 아이콘에 대한 핸들에 대한 포인터입니다. 이 함수를 호출하는 애플리케이션이 아이콘을 사용하여 완료되면 애플리케이션은 DestroyIcon 을 호출하여 아이콘을 삭제해야 합니다. (DestroyIcon은 Microsoft Windows SDK 문서화되어 있습니다.)

반환 값

함수가 지정된 디바이스의 아이콘을 검색하는 데 성공하면 SetupDiLoadDeviceIcon은 TRUE를 반환합니다. 그렇지 않으면 함수가 FALSE 를 반환하고 GetLastError 호출을 통해 기록된 오류를 검색할 수 있습니다.

설명

SetupDiLoadDeviceIcon 은 다음과 같이 디바이스의 아이콘을 검색하려고 시도합니다.

• 디바이스의 DEVPKEY_DrvPkg_Icon 디바이스 속성에 리소스 식별자 문자열 목록이 포함된 경우 함수는 목록의 첫 번째 리소스 식별자 문자열로 지정된 아이콘을 검색하려고 시도합니다.

  DEVPKEY_DrvPkg_Icon 디바이스 속성의 디바이스 속성 데이터 형식은 DEVPROP_TYPE_STRING_LIST.

  리소스 식별자 문자열의 형식은 다음과 같습니다.

  [filepath\]filename,-resourceID
  

  위치:

  • filepath 뒤에 백슬래시 문자(\\)는 선택 사항이며 아이콘이 포함된 파일의 경로를 지정합니다.
  • FileName 뒤에 쉼표 문자(",")가 표시되면 아이콘이 포함된 파일의 이름을 지정합니다.
  • 대시 문자("-")가 앞에 오는 ResourceID는 아이콘의 리소스 ID를 지정합니다.
• 함수가 디바이스별 아이콘을 검색할 수 없는 경우 디바이스의 클래스 아이콘을 검색하려고 시도합니다. 클래스 아이콘에 대한 자세한 내용은 SetupDiLoadClassIcon을 참조하세요.
• 함수가 디바이스의 클래스 아이콘을 검색할 수 없는 경우 알 수 없는 디바이스 설정 클래스의 아이콘을 검색하려고 시도합니다. 여기서 알 수 없는 디바이스 설정 클래스의 아이콘에는 물음표(?)의 이미지가 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib
DLL	Setupapi.dll

추가 정보

DEVPROP_TYPE_STRING_LIST

SetupDiLoadClassIcon