共用方式為

EngCreateWnd 函式 (winddi.h)

  • 發行項

EngCreateWnd 函式會為 hwnd 所參考的視窗建立 WNDOBJ 結構。

語法

ENGAPI WNDOBJ * EngCreateWnd(
  SURFOBJ          *pso,
  HWND             hwnd,
  WNDOBJCHANGEPROC pfn,
  FLONG            fl,
  int              iPixelFormat
);

參數

pso

識別裝置表面 之 SURFOBJ 結構的指標。

hwnd

處理應用程式呼叫 Win32 CreateWindow 或對等函式所建立的視窗。

pfn

fl

這是一個位掩碼，指定 GDI 應該追蹤和回報給驅動程式的變更類型。 此值必須透過驅動程式提出的所有 WNDOBJ 要求保持一致。 此參數可以是下列一或多個位欄位值：

旗標 意義
WO_DRAW_NOTIFY GDI 應該提供驅動程式WOC_DRAWN通知。
WO_RGN_CLIENT GDI 應該追蹤視窗物件的用戶端區域中的變更，並在視窗可見的用戶端區域變更時通知驅動程式。 回呼函式中列舉的區域是視窗的新可見工作區。
WO_RGN_CLIENT_DELTA GDI 應該追蹤視窗物件差異用戶端區域中的變更，並在視窗可見區域變更時通知驅動程式。 回呼函式中列舉的區域是位於新區域，但不在舊區域中的無空差異區域。 差異區域只在回呼期間有效。
WO_RGN_DESKTOP_COORD GDI 會在系統執行多個監視器時，建立具有桌面座標的 WNDOBJ 結構。

GDI 會忽略此旗標，並在系統執行單一監視器時，建立具有裝置座標的 WNDOBJ 結構。
WO_RGN_SURFACE GDI 應該追蹤視窗物件介面區域中的變更，並在介面區域變更時通知驅動程式。 介面區域是顯示介面區，不包括驅動程式所追蹤視窗的所有可見客戶端區域。
WO_RGN_SURFACE_DELTA GDI 應該追蹤視窗對象差異介面區域中的變更，並在介面區域變更時通知驅動程式。 回呼函式中列舉的區域是位於新介面區域中，但不在舊介面區域中的無空差異區域。 差異表面區域只在回呼期間有效。
WO_RGN_UPDATE_ALL GDI 應該通知驅動程式在其任何視窗的可見區域變更時追蹤的所有視窗。 這個旗標必須與 WO_RGN_CLIENT 旗標搭配使用。
WO_RGN_WINDOW GDI 應該追蹤視窗物件 (整個區域中的變更，其中包括視窗) 的客戶端區域，並在視窗的區域變更時通知驅動程式。
WO_SPRITE_NOTIFY 當 Windows 的任何可見區域重疊或 Sprite 不再重疊時，GDI 應該通知驅動程式它追蹤的所有視窗。

iPixelFormat

指定與視窗對象相關聯的像素格式。 視窗物件的像素格式是固定的。 如果沒有相關聯的圖元格式，這個參數可以是零。

傳回值

如果函式成功，傳回值是 WNDOBJ 結構的指標。 否則，如果驅動程式正在追蹤相同的視窗，則傳回值為 -1;如果驅動程式未追蹤相同的視窗，則傳回值為零。

備註

因為建立窗口物件牽涉到鎖定窗口資源， 所以 EngCreateWnd 應該只在 DrvEscape中逸出WNDOBJ_SETUP的內容中呼叫。

EngCreateWnd 支援多個驅動程式的窗口追蹤，其中每個驅動程式都是由 pfn 所識別的唯一 WNDOBJCHANGEPROC 函式指標所識別。 例如，實時視訊驅動程式可以在 OpenGL 驅動程式追蹤 OpenGL 視窗的變更時追蹤即時視訊視窗的變更。

如果DrvEscape建立新的WNDOBJ，GDI會以最新的窗口狀態呼叫 WNDOBJCHANGEPROC。 當WNDOBJ結構所描述的窗口終結時，GDI也會通知 WNDOBJCHANGEPROC 。

傳遞至 WNDOBJCHANGEPROC 的WOC_SPRITE_OVERLAP和WOC_SPRITE_NO_OVERLAP通知可讓驅動程式在其視窗上方同步通知，並採取適當的動作。 驅動程式會接收這些通知，即使所有Sprite都已由 EngControlSprites的 ECS_TEARDOWN旗標損毀也一樣。

規格需求

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

另請參閱

DrvEscape

WNDOBJ

WNDOBJCHANGEPROC