共用方式為


EngCreateDeviceSurface 函式 (winddi.h)

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

語法

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

參數

[in] dhsurf

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

[in] sizl

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

iFormatCompat

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

傳回值

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

備註

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

規格需求

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

另請參閱

EngAssociateSurface

EngDeleteSurface

SURFOBJ