共用方式為

CLIPOBJ_bEnum函式 (winddi.h)

  • 發行項

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 作業系統中使用。
目標平台 Universal
標頭 winddi.h (包括 Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS