winddi.h) (CLIPOBJ_bEnum 函数

  • 项目

CLIPOBJ_bEnum 函数枚举指定剪辑区域中的一批矩形;对 CLIPOBJ_cEnumStart 的先前调用确定枚举的顺序。

语法

ENGAPI BOOL CLIPOBJ_bEnum(
  [in]  CLIPOBJ *pco,
  [in]  ULONG   cj,
  [out] ULONG   *pul
);

参数

[in] pco

指向描述要枚举的剪辑区域的 CLIPOBJ 结构的指针。

[in] cj

指定 pv 指向的缓冲区的大小（以字节为单位）。

[out] pul

指向缓冲区的指针，该缓冲区将接收 ENUMRECTS 结构中有关剪辑区域的数据。

返回值

如果驱动程序必须再次调用此函数以获取更多枚举数据，则返回值为 TRUE ;如果枚举完成，则返回值为 FALSE 。 CLIPOBJ_bEnum可以返回 TRUE，剪裁矩形的数目等于零。 在这种情况下，驱动程序应再次调用 CLIPOBJ_bEnum ，而无需执行任何操作。

注解

调用此函数的可能循环结构如下：

do {
    bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) {
        .
        .
        .
    }
} while (bMore);

写入缓冲区的对象计数将写入缓冲区本身。

要求

要求 值
最低受支持的客户端 在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS