EngModifySurface 函式 (winddi.h)

EngModifySurface 函式會通知 GDI 有關驅動程式所建立表面的屬性。

語法

ENGAPI BOOL EngModifySurface(
  HSURF  hsurf,
  HDEV   hdev,
  FLONG  flHooks,
  FLONG  flSurface,
  DHSURF dhsurf,
  VOID   *pvScan0,
  LONG   lDelta,
  VOID   *pvReserved
);

參數

hsurf

要修改之表面的句柄。 此參數是 EngCreateDeviceBitmap 或 EngCreateDeviceSurface 所傳回的介面句柄，或是從 SURFOBJ 結構的 hsurf 成員傳回。

hdev

要與介面相關聯之裝置的句柄。 這是 GDI 傳遞至 DrvCompletePDEV的句柄。

flHooks

這是一組旗標，可控制驅動程式在指定的介面上發生 GDI 繪圖時可攔截的函式。 這可以是 EngAssociateSurface 參考頁面上所列任何HOOK_Xxx 值的位 OR。

flSurface

這是描述介面屬性的一組旗標。 目前，當介面位於視訊記憶體時，驅動程式應該將此設定為MS_NOTSYSTEMMEMORY。

dhsurf

識別驅動程式的介面。 驅動程式可以將此設定為任何專案;如果函式成功，GDI 會將所產生表面 SURFOBJ 結構的 dhsurf 成員設定為這個值。

pvScan0

位圖開頭之虛擬位址的指標。

lDelta

這是點陣圖的虛擬位址步幅;也就是說，位圖數據列開頭與下一個點陣圖數據列之間的位元元組數目。

pvReserved

是保留的，而且必須一律設定為 NULL。

傳回值

EngModifySurface 會在成功時傳回 TRUE ;否則會傳回 FALSE。

備註

EngModifySurface 可讓驅動程式修改 裝置管理的介面 ，並通知 GDI 此表面的屬性。 這可讓驅動程式將目的地介面從不透明轉換為非paque，因此允許 GDI 繪製在介面上。

DIB 引擎會使用 pvScan0 和 lDelta 直接繪製到表面。 當這些參數為 NULL 時，介面對 GDI 不透明，而 GDI 會還原為呼叫 DrvCopyBits ，以取得驅動程式未連結的繪圖作業。

DrvEnableSurface 傳回主要介面的句柄之後，請勿在該句柄上呼叫 EngModifySurface。 這樣做可能會導致在某些情況下進行錯誤檢查。 如需詳細資訊，請參閱 Microsoft 知識庫文章330248。

規格需求

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

另請參閱

DrvCopyBits

EngAssociateSurface