Función SetupDiLoadDeviceIcon (setupapi.h)

La función SetupDiLoadDeviceIcon recupera un icono para un dispositivo especificado.

Sintaxis

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

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene el elemento de información del dispositivo que representa el dispositivo para el que se va a recuperar un icono.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

[in] cxIcon

Ancho, en píxeles, del icono que se va a recuperar. Use el índice de métricas del sistema SM_CXICON para especificar un icono de tamaño predeterminado o use el índice de métricas del sistema SM_CXSMICON para especificar un icono pequeño. Los índices de métricas del sistema se definen en Winuser.h y sus valores asociados se pueden recuperar mediante una llamada a la función GetSystemMetrics . (La función GetSystemMetrics se documenta en el Microsoft Windows SDK).

[in] cyIcon

Alto, en píxeles, del icono que se va a recuperar. Use SM_CXICON para especificar un icono de tamaño predeterminado o use SM_CXSMICON para especificar un icono pequeño.

[in] Flags

No se usa. Debe establecerse en cero.

[out] hIcon

Puntero a un identificador de un icono que recibe un identificador al icono que recupera esta función. Una vez finalizada la aplicación que llama a esta función mediante el icono, la aplicación debe llamar a DestroyIcon para eliminar el icono. (DestroyIcon se documenta en el Microsoft Windows SDK).

Valor devuelto

SetupDiLoadDeviceIcon devuelve TRUE si la función se realiza correctamente al recuperar el icono del dispositivo especificado. De lo contrario, la función devuelve FALSE y el error registrado se puede recuperar mediante una llamada a GetLastError.

Comentarios

SetupDiLoadDeviceIcon intenta recuperar un icono para el dispositivo de la siguiente manera:

• Si la propiedad DEVPKEY_DrvPkg_Icon dispositivo del dispositivo incluye una lista de cadenas de identificador de recursos, la función intenta recuperar el icono especificado por la primera cadena de identificador de recurso de la lista.

  El tipo de datos de propiedad del dispositivo de DEVPKEY_DrvPkg_Icon propiedad de dispositivo es DEVPROP_TYPE_STRING_LIST.

  El formato de una cadena de identificador de recurso es

  [filepath\]filename,-resourceID
  

  Donde:

  • filepath, seguido del carácter de barra diagonal inversa (\\), es opcional y especifica una ruta de acceso del archivo que contiene el icono.
  • FileName, seguido del carácter de coma (",") especifica el nombre del archivo que contiene el icono.
  • ResourceID, precedido por un carácter de guión ("-"), especifica el identificador de recurso del icono.
• Si la función no puede recuperar un icono específico del dispositivo, intentará recuperar el icono de clase del dispositivo. Para obtener información sobre los iconos de clase, vea SetupDiLoadClassIcon.
• Si la función no puede recuperar el icono de clase del dispositivo, intentará recuperar el icono de la clase de instalación de dispositivo Desconocido, donde el icono de la clase de instalación de dispositivo Desconocido incluye la imagen de un signo de interrogación (?).

Requisitos

Consulte también

DEVPROP_TYPE_STRING_LIST

SetupDiLoadClassIcon