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 |