IDirectDrawSurface7：：UpdateOverlay 方法 (ddraw.h)
重新定位或修改重疊表面的視覺屬性。 這些表面必須設定DDSCAPS_OVERLAY旗標。
語法
HRESULT UpdateOverlay(
[in] LPRECT unnamedParam1,
[in] LPDIRECTDRAWSURFACE7 unnamedParam2,
[in] LPRECT unnamedParam3,
[in] DWORD unnamedParam4,
[in] LPDDOVERLAYFX unnamedParam5
);
參數
[in] unnamedParam1
RECT 結構的指標，定義來源介面上做為重疊的區域 x、y、寬度和高度。 此參數可以是 NULL 來隱藏重疊，或表示要使用整個重疊表面，而且重疊表面符合設備驅動器所加加的任何界限和大小對齊限制。
[in] unnamedParam2
要重載之 DirectDrawSurface 物件的 IDirectDrawSurface7 介面指標。
[in] unnamedParam3
RECT 結構的指標，定義目的地介面上應該移動重疊的區域寬度、x 和高度 y。 此參數可以是 NULL，可隱藏重疊。
[in] unnamedParam4
下列旗標的組合，可決定重迭更新：
DDOVER_ADDDIRTYRECT
將已變更的矩形新增至仿真的重疊表面。
DDOVER_ALPHADEST
已過時。
DDOVER_ALPHADESTCONSTOVERRIDE
使用 DDOVERLAYFX 結構的 dwAlphaDestConst 成員做為此重疊的目的地 Alpha 色板。
DDOVER_ALPHADESTNEG
表示當 Alpha 值增加 (0 不透明) 時，目的地表面會變得更透明。
DDOVER_ALPHADESTSURFACEOVERRIDE
使用 DDOVERLAYFX 結構的 lpDDSAlphaDest 成員做為此重疊的 Alpha 通道目的地。
DDOVER_ALPHAEDGEBLEND
使用 DDOVERLAYFX 結構的 dwAlphaEdgeBlend 成員做為框線色彩索引鍵色彩之影像邊緣的 Alpha 色板。
DDOVER_ALPHASRC
使用圖元格式的 Alpha 資訊，或附加至來源介面的 Alpha 色板作為這個重疊的來源 Alpha 色板。
DDOVER_ALPHASRCCONSTOVERRIDE
使用 DDOVERLAYFX 結構的 dwAlphaSrcConst 成員作為這個重疊的來源 Alpha 色板。
DDOVER_ALPHASRCNEG
表示來源表面在alpha值增加時變得更透明， (0為不透明) 。
DDOVER_ALPHASRCSURFACEOVERRIDE
使用 DDOVERLAYFX 結構的 lpDDSAlphaSrc 成員做為此重疊的 Alpha 色板來源。
DDOVER_ARGBSCALEFACTORS
DirectX 7.0 的新功能。 表示 DDOVERLAYFX 結構包含有效的 ARGB 縮放比例。
DDOVER_AUTOFLIP
每次發生視訊埠 VSYNC 時，自動翻轉鏈結中的下一個表面。
DDOVER_BOB
個別顯示交錯視訊數據流的每個字段，而不會造成任何成品顯示。
DDOVER_BOBHARDWARE
Bob 作業是使用硬體來執行，而不是使用軟體或模擬。 這個旗標必須與DDOVER_BOB旗標搭配使用。
DDOVER_DDFX
使用 lpDDOverlayFx 參數中的重疊 FX 旗標來定義特殊的重疊效果。
DDOVER_DEGRADEARGBSCALING
DirectX 7.0 的新功能。 ARGB 縮放比例可能會降低，以符合驅動程式功能。
DDOVER_HIDE
關閉此重疊。
DDOVER_INTERLEAVED
表面記憶體是由交錯的欄位所組成。
DDOVER_KEYDEST
使用與目的地介面相關聯的色彩索引鍵。
DDOVER_KEYDESTOVERRIDE
使用 DDOVERLAYFX 結構的 dckDestColorkey 成員做為目的地介面的色彩索引鍵。
DDOVER_KEYSRC
使用與來源介面相關聯的色彩索引鍵。
DDOVER_KEYSRCOVERRIDE
使用 DDOVERLAYFX 結構的 dckSrcColorkey 成員做為來源介面的色彩索引鍵。
DDOVER_OVERRIDEBOBWEAVE
Bob 和 weave 決策不應由其他介面覆寫。
DDOVER_REFRESHALL
在模擬重疊表面上重新繪製整個表面。
DDOVER_REFRESHDIRTYRECTS
在模擬重疊表面重繪所有已變更的矩形。
DDOVER_SHOW
開啟此重疊。
[in] unnamedParam5
DDOVERLAYFX 結構的指標，描述要使用的效果。 如果未指定DDOVER_DDFX旗標，可以是 NULL。
傳回值
如果方法成功，傳回值會DD_OK。
如果失敗，方法可以傳回下列其中一個錯誤值：
- DDERR_DEVICEDOESNTOWNSURFACE
- DDERR_GENERIC
- DDERR_HEIGHTALIGN
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_INVALIDRECT
- DDERR_INVALIDSURFACETYPE
- DDERR_NOSTRETCHHW
- DDERR_NOTAOVERLAYSURFACE
- DDERR_OUTOFCAPS
- DDERR_SURFACELOST
- DDERR_UNSUPPORTED
- DDERR_XALIGN
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | ddraw.h |
| 程式庫 | Ddraw.lib |
| Dll | Ddraw.dll |