共用方式為


WNDOBJ_cEnumStart函式 (winddi.h)

WNDOBJ_cEnumStart函式是回 函式,可設定在視窗可見區域中列舉矩形的參數。

語法

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

參數

pwo

呼叫 EngCreateWnd 所建立之 WNDOBJ 結構的指標。

iType

指定要由 WNDOBJ_bEnum傳回的結構類型。 此參數可以CT_RECTANGLES,這表示區域要列舉為矩形清單。

iDirection

決定傳回矩形的順序。 在相同介面上執行重疊 的DrvBitBlt 時,這個順序可能很重要。 如果順序與設備驅動器無關,則應該指定CD_ANY。 這可讓 GDI 針對複雜區域優化其列舉。 此參數可以是下列其中一個值:

意義
CD_ANY 任何方便 GDI 的訂單。
CD_LEFTDOWN 由右至左、由上至下。
CD_LEFTUP 由右至左、由下至上。
CD_LEFTWARDS 未定義由左至右的垂直方向。
CD_RIGHTDOWN 由左至右、由上至下。
CD_RIGHTUP 由左至右、由下至上。
CD_UPWARDS 從下到上,未定義水準方向。

cLimit

這是驅動程式對快取感興趣之物件數目的指示。 這隻會用來決定何時停止計算矩形,而 GDI 正在計算此函式的傳回值。 如果 cLimit 為零,則不會完成計數。

傳回值

傳回值是列舉物件的計數,前提是此值小於或等於 cLimit。 如果計數大於 cLimit,則傳回值會0xFFFFFFFF。

備註

您可以再次呼叫此函式來重新啟動列舉。

WNDOBJ_cEnumStart應該 只呼叫:

  • EngCreateWnd 函式中提供給 GDI 的驅動程式回呼函式內容中,或提供 WNDOBJ 的圖形 DDI 函式。
  • 當呼叫線程具有裝置鎖定時,可確保不會發生任何客戶端區域變更。

規格需求

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

另請參閱

DrvBitBlt

EngCreateWnd

EngLockDriverObj

WNDOBJ

WNDOBJ_bEnum