IDirectDrawSurface7::UpdateOverlay メソッド (ddraw.h)

[アーティクル]
02/29/2024

オーバーレイサーフェスのビジュアル属性を再配置または変更します。これらのサーフェスには、DDSCAPS_OVERLAY フラグが設定されている必要があります。

構文

HRESULT UpdateOverlay(
  [in] LPRECT               unnamedParam1,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam2,
  [in] LPRECT               unnamedParam3,
  [in] DWORD                unnamedParam4,
  [in] LPDDOVERLAYFX        unnamedParam5
);

パラメーター

[in] unnamedParam1

オーバーレイとして使用されるソースサーフェス上の領域の x、y、幅、および高さを定義する RECT 構造体へのポインター。このパラメーターは、オーバーレイを非表示にしたり、オーバーレイサーフェス全体を使用し、オーバーレイサーフェスがデバイスドライバーによって課される境界とサイズ配置の制限に準拠していることを示したりするために NULL にすることができます。

[in] unnamedParam2

オーバーレイされている DirectDrawSurface オブジェクトの IDirectDrawSurface7 インターフェイスへのポインター。

[in] unnamedParam3

オーバーレイの移動先サーフェス上の領域の幅、x、および高さ y を定義する RECT 構造体へのポインター。オーバーレイを非表示にするには、このパラメーターに NULL を指定できます。

[in] unnamedParam4

オーバーレイの更新を決定する次のフラグの組み合わせ。

DDOVER_ADDDIRTYRECT

エミュレートされたオーバーレイサーフェスにダーティ四角形を追加します。

DDOVER_ALPHADEST

互換性のために残されています。

DDOVER_ALPHADESTCONSTOVERRIDE

DDOVERLAYFX 構造体の dwAlphaDestConst メンバーを、このオーバーレイの宛先アルファチャネルとして使用します。

DDOVER_ALPHADESTNEG

アルファ値が増加すると、ターゲットサーフェスがより透明になることを示します (0 は不透明)。

DDOVER_ALPHADESTSURFACEOVERRIDE

DDOVERLAYFX 構造体の lpDDSAlphaDest メンバーを、このオーバーレイのアルファチャネルの宛先として使用します。

DDOVER_ALPHAEDGEBLEND

DDOVERLAYFX 構造体の dwAlphaEdgeBlend メンバーを、カラーキーの色に接するイメージのエッジのアルファチャネルとして使用します。

DDOVER_ALPHASRC

このオーバーレイのソースアルファチャネルとして、ピクセル形式のアルファ情報またはソースサーフェスにアタッチされたアルファチャネルサーフェスを使用します。

DDOVER_ALPHASRCCONSTOVERRIDE

DDOVERLAYFX 構造体の dwAlphaSrcConst メンバーを、このオーバーレイのソースアルファチャネルとして使用します。

DDOVER_ALPHASRCNEG

アルファ値が増加するとソースサーフェスの透明度が高くなることを示します (0 は不透明)。

DDOVER_ALPHASRCSURFACEOVERRIDE

DDOVERLAYFX 構造体の lpDDSAlphaSrc メンバーを、このオーバーレイのアルファチャネルソースとして使用します。

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 と織りの決定は、他のインターフェイスによってオーバーライドされるべきではありません。

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
Library	Ddraw.lib
[DLL]	Ddraw.dll

こちらもご覧ください

IDirectDrawSurface7

次の方法で共有