Función SetupDiDrawMiniIcon (setupapi.h)

La función SetupDiDrawMiniIcon dibuja el miniicono especificado en la ubicación solicitada.

Sintaxis

WINSETUPAPI INT SetupDiDrawMiniIcon(
  [in] HDC   hdc,
  [in] RECT  rc,
  [in] INT   MiniIconIndex,
  [in] DWORD Flags
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo en el que se dibujará el miniicono.

[in] rc

Rectángulo del identificador de contexto del dispositivo especificado para dibujar el miniicono en.

[in] MiniIconIndex

Índice del miniicono, tal y como se recupera de SetupDiLoadClassIcon o SetupDiGetClassBitmapIndex. Se pueden usar los siguientes índices predefinidos para dispositivos:

Clase	Índice
Equipo o sistema	0
Mostrar o supervisar	2
Adaptador de red	3
Mouse	5
Teclado	6
Sonido	8
FDC/HDC	9
Puertos	10
Impresora	14
Transporte de red	15
Cliente de red	16
Servicio de red	17
Unknown	18

[in] Flags

Estas marcas controlan la operación de dibujo. LoWORD contiene las marcas reales definidas de la siguiente manera:

DMI_MASK

Dibuje la máscara del miniicono en HDC.

DMI_BKCOLOR

Use el índice de color del sistema especificado en la HIWORD de Flags como color de fondo. Si no se establece esta marca, se usa COLOR_WINDOW.

DMI_USERECT

Si se establece, SetupDiDrawMiniIcon usa el rectángulo proporcionado y amplía el icono para ajustarse.

Valor devuelto

Esta función devuelve el desplazamiento desde el lado izquierdo de rc donde se debe iniciar la cadena. Si se produce un error en la operación de dibujo, la función devuelve cero.

Comentarios

De forma predeterminada, el icono se centra verticalmente y se fuerza en el lado izquierdo del rectángulo especificado.

SetupDiDrawMiniIcon dibuja la versión de 16 bits del icono especificado por el parámetro MiniIconIndex . En lugar de SetupDiDrawMiniIcon, debe usar SetupDiLoadClassIcon junto con DrawIcon o DrawIconEx para dibujar la versión de 32 bits del icono. A continuación se muestra un ejemplo de cómo usar DrawIconEx para mostrar un icono:

HICON hIcon;

if (SetupDiLoadClassIcon(&GUID_DEVCLASS_USB, &hIcon, NULL)) {
    DrawIconEx(hDC, 0, 0, hIcon, GetSystemMetrics(SM_CXSMICON),GetSystemMetrics(SM_CYSMICON), 0, NULL, DI_NORMAL); 
DestroyIcon(hIcon);
}

Para obtener más información sobre DrawIcon o DrawIconEx, consulte la documentación del Kit de desarrollo de software (SDK) de Microsoft Windows para Windows 7 y .NET Framework 4.0.

Requisitos

Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll

Consulte también

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon