共用方式為

WNDOBJ_bEnum函式 (winddi.h)

  • 發行項

WNDOBJ_bEnum函式會從視窗的可見區域取得一批矩形。

語法

ENGAPI BOOL WNDOBJ_bEnum(
  WNDOBJ *pwo,
  ULONG  cj,
  ULONG  *pul
);

參數

pwo

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

cj

指定 pul所指向緩衝區的大小，以位元組為單位。 GDI 不會寫入超過此限制。

pul

要寫入下列表單結構的緩衝區指標。 在此結構中， c 是傳回的矩形計數，而 arcl 是矩形的陣列：

typedef struct _ENUMRECTS{
    ULONG c;
    RECTL arcl[]
} ENUMRECTS;

傳回值

如果有更多資料要列舉，且驅動程式應該重複呼叫，則傳回值為 TRUE 。 如果列舉完成，則為 FALSE 。

備註

列舉的順序取決於 呼叫WNDOBJ_cEnumStart。

呼叫此函式的可能迴圈結構如下。

do {
    bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) { 
        //  Process the data
    }
} while (bMore);

WNDOBJ_bEnum 應該只由 由 EngCreateWnd 函式提供給 GDI 的回呼函式呼叫，或是由指定的 WNDOBJ 圖形 DDI 函式呼叫。

規格需求

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

另請參閱

EngCreateWnd

WNDOBJ

WNDOBJ_cEnumStart