Funzione SetupDiLoadDeviceIcon (setupapi.h)

Articolo
03/01/2024

La funzione SetupDiLoadDeviceIcon recupera un'icona per un dispositivo specificato.

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene l'elemento informazioni sul dispositivo che rappresenta il dispositivo per cui recuperare un'icona.

[in] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.

[in] cxIcon

Larghezza, in pixel, dell'icona da recuperare. Usare l'indice delle metriche di sistema SM_CXICON per specificare un'icona di dimensioni predefinite o usare l'indice delle metriche di sistema SM_CXSMICON per specificare un'icona di piccole dimensioni. Gli indici delle metriche di sistema vengono definiti in Winuser.h e i relativi valori associati possono essere recuperati da una chiamata alla funzione GetSystemMetrics . La funzione GetSystemMetrics è documentata nella Microsoft Windows SDK.

[in] cyIcon

Altezza, in pixel, dell'icona da recuperare. Usare SM_CXICON per specificare un'icona di dimensioni predefinite o usare SM_CXSMICON per specificare un'icona di piccole dimensioni.

[in] Flags

Non usato. Deve essere impostato su zero.

[out] hIcon

Puntatore a un handle a un'icona che riceve un handle all'icona recuperata da questa funzione. Al termine dell'applicazione che chiama questa funzione usando l'icona, l'applicazione deve chiamare DestroyIcon per eliminare l'icona. (DestroyIcon è documentato nella Microsoft Windows SDK.

Valore restituito

SetupDiLoadDeviceIcon restituisce TRUE se la funzione riesce a recuperare l'icona per il dispositivo specificato. In caso contrario, la funzione restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.

Commenti

SetupDiLoadDeviceIcon tenta di recuperare un'icona per il dispositivo come indicato di seguito:

Se la proprietà del dispositivo DEVPKEY_DrvPkg_Icon include un elenco di stringhe di identificatore di risorsa, la funzione tenta di recuperare l'icona specificata dalla prima stringa di identificatore di risorsa nell'elenco.
Il tipo di dati della proprietà dispositivo della proprietà del dispositivo DEVPKEY_DrvPkg_Icon è DEVPROP_TYPE_STRING_LIST.

Il formato di una stringa di identificatore di risorsa è
```
[filepath\]filename,-resourceID
```
Dove:
- filepath, seguito dal carattere barra rovesciata (\\), è facoltativo e specifica un percorso del file che contiene l'icona.
- FileName, seguito dal carattere virgola (",") specifica il nome del file che contiene l'icona.
- ResourceID, preceduto da un carattere trattino ("-"), specifica l'ID risorsa dell'icona.
Se la funzione non riesce a recuperare un'icona specifica del dispositivo, tenterà di recuperare l'icona della classe per il dispositivo. Per informazioni sulle icone delle classi, vedere SetupDiLoadClassIcon.
Se la funzione non riesce a recuperare l'icona della classe per il dispositivo, tenterà di recuperare l'icona per la classe di installazione del dispositivo Sconosciuto, dove l'icona per la classe di configurazione del dispositivo Sconosciuto include l'immagine di un punto interrogativo (?).

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (includere Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

DEVPROP_TYPE_STRING_LIST

SetupDiLoadClassIcon

Condividi tramite