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

另請參閱

IDirectDrawSurface7