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 |