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 將列舉優化。這個值可以是下列其中一個值：

[in] cLimit

指定要列舉的矩形數目上限。如果此參數為零，則會省略計數。

傳回值是列舉矩形的計數。如果計數超過 cLimit，則會0xFFFFFFFF傳回值。

是否呼叫此函式，都可以列舉區域。根據預設，驅動程式只會列舉從左上方開始的相關矩形。

驅動程式可以再次呼叫此函式來重新開機列舉。


最低支援的用戶端	適用于 Windows 2000 和更新版本的 Windows 作業系統。
目標平台	Universal
標頭	winddi.h (包含 Winddi.h)
程式庫	Win32k.lib
Dll	Win32k.sys