CLIPOBJ_cEnumStart函数 (winddi.h)
CLIPOBJ_cEnumStart 函数设置用于枚举指定剪辑区域中的矩形的参数。
语法
ENGAPI ULONG CLIPOBJ_cEnumStart(
[in] CLIPOBJ *pco,
[in] BOOL bAll,
[in] ULONG iType,
[in] ULONG iDirection,
[in] ULONG cLimit
);
参数
[in] pco
指向 CLIPOBJ 结构的指针，该结构定义要枚举的剪辑区域。
[in] bAll
指定是否应枚举整个区域。 如果应枚举整个区域，则此参数为 TRUE 。 如果仅应枚举与当前绘图操作相关的部分，则为 FALSE 。
缓存剪辑区域的驱动程序必须枚举整个区域。
[in] iType
指定要由 CLIPOBJ_bEnum写入的数据结构。 此参数当前必须CT_RECTANGLES，表示要枚举为矩形列表的区域。
[in] iDirection
确定枚举矩形的顺序。 如果 DrvBitBlt 操作在同一图面上同时执行，则此顺序可能至关重要。 如果顺序与设备驱动程序无关，则应为复杂区域指定CD_ANY，以便 GDI 优化枚举。 此值可以为下列值之一：
| 值 | 含义 |
|---|---|
| CD_ANY | 任何方便 GDI 的订单。 |
| CD_LEFTDOWN | 从右到左，从上到下。 |
| CD_LEFTUP | 从右到左，从下到上。 |
| CD_RIGHTDOWN | 从左到右，从上到下。 |
| CD_RIGHTUP | 从左到右，从下到上。 |
[in] cLimit
指定要枚举的最大矩形数。 如果此参数为零，则省略计数。
返回值
返回值是枚举矩形的计数。 如果计数超过 cLimit，则返回值为0xFFFFFFFF。
备注
无论是否调用此函数，都可以枚举区域。 默认情况下，驱动程序仅枚举从左上角开始的相关矩形。
驱动程序可以通过再次调用此函数来重启枚举。
要求
| 最低受支持的客户端 | 适用于 Windows 2000 及更高版本的 Windows 操作系统。 |
| 目标平台 | 通用 |
| 标头 | winddi.h (包括 Winddi.h) |
| Library | Win32k.lib |
| DLL | Win32k.sys |