EngCreateDeviceSurface 函式 (winddi.h)

EngCreateDeviceSurface 函式會建立並傳回驅動程式將管理之裝置介面的句柄。

語法

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

[in] dhsurf

裝置所管理表面的裝置句柄。當針對輸入或輸出傳遞 SURFOBJ 結構時，這個句柄會傳遞至驅動程式。

[in] sizl

指定 SIZEL 結構，其中包含要建立之表面的寬度和高度。此結構的 cx 和 cy 成員分別包含表面的寬度和高度，以像素為單位。 SIZEL 結構與 SIZE 結構相同。

iFormatCompat

指定所建立之裝置介面的相容引擎格式。如果需要暫存緩衝區來模擬複雜的繪圖呼叫，則 GDI 會使用此緩衝區。

如果函式成功，傳回值是識別介面的句柄。否則，它會是零，而且會記錄錯誤碼。

驅動程式可以選擇性地提供表面的儲存空間。介面應該使用 EngAssociateSurface 來建立關聯。使用 EngDeleteSurface 不再需要表面時，應該刪除表面。

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