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 |