SetupDiDrawMiniIcon 函式 (setupapi.h)
SetupDiDrawMiniIcon函式會在要求的位置繪製指定的走勢圖標。
語法
WINSETUPAPI INT SetupDiDrawMiniIcon(
[in] HDC hdc,
[in] RECT rc,
[in] INT MiniIconIndex,
[in] DWORD Flags
);
參數
[in] hdc
將繪製走勢圖標之裝置內容的控制碼。
[in] rc
指定裝置內容控制碼中的矩形，用來繪製走勢圖標。
[in] MiniIconIndex
從 SetupDiLoadClassIcon 或 SetupDiGetClassBitmapIndex擷取的走勢圖標索引。 您可以使用下列預先定義的裝置索引：
| 類別 | 索引 |
|---|---|
| 電腦/系統 | 0 |
| 顯示/監視器 | 2 |
| 網路介面卡 | 3 |
| 滑鼠 | 5 |
| 鍵盤 | 6 |
| 音效 | 8 |
| FDC/HDC | 9 |
| 連接埠 | 10 |
| 印表機 | 14 |
| 網路傳輸 | 15 |
| 網路用戶端 | 16 |
| 網路服務 | 17 |
| Unknown | 18 |
[in] Flags
這些旗標會控制繪圖作業。 LOWORD 包含定義的實際旗標，如下所示：
DMI_MASK
將走勢圖標的遮罩繪製到 HDC 中。
DMI_BKCOLOR
使用在 [ 旗 標的 HIWORD] 中指定的系統色彩索引做為背景色彩。 如果未設定此旗標，則會使用COLOR_WINDOW。
DMI_USERECT
如果設定， SetupDiDrawMiniIcon 會使用提供的矩形，並延展圖示以容納。
傳回值
此函式會從 rc 左側傳回應該啟動字串的位移。 如果繪製作業失敗，函式會傳回零。
備註
根據預設，圖示會垂直置中，並針對指定矩形的左側強制。
SetupDiDrawMiniIcon 繪製 MiniIconIndex 參數所指定的圖示 16 位版本。 您應該使用SetupDiLoadClassIcon搭配DrawIcon或DrawIconEx來繪製 32 位版本的圖示，而不是SetupDiDrawMiniIcon。 以下是如何使用 DrawIconEx 來顯示圖示的範例：
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);
}
如需DrawIcon或DrawIconEx的詳細資訊，請參閱 Microsoft Windows 軟體發展工具組 (SDK) for Windows 7 和 .NET Framework 4.0 檔。
需求
| 最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌上型 |
| 標頭 | setupapi.h (包括 Setupapi.h) |
| 程式庫 | Setupapi.lib |
| Dll | Setupapi.dll |