IDCompositionVisual::SetContent メソッド (dcomp.h)

このビジュアルの Content プロパティを、指定したビットマップまたはウィンドウ ラッパーに設定します。

構文

HRESULT SetContent(
  [in, optional] IUnknown *content
);

パラメーター

[in, optional] content

種類: IUnknown*

このビジュアルの新しいコンテンツである オブジェクト。 このパラメーターは、NULL でもかまいません。

戻り値

型: HRESULT

関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。

注釈

content パラメーターは、次のいずれかを指す必要があります。

• IDCompositionSurface インターフェイスを実装する オブジェクト。
• IDXGISwapChain1 インターフェイスを実装する オブジェクト。
• CreateSurfaceFromHandle メソッドまたは CreateSurfaceFromHwnd メソッドによって返されるラッパー オブジェクト。

ビジュアルは、ビットマップ オブジェクトまたはウィンドウ ラッパーに関連付けることができます。 ビットマップは、Microsoft DirectX スワップ チェーンまたは Microsoft DirectComposition サーフェスです。

ウィンドウ ラッパーは CreateSurfaceFromHwnd メソッドを使用して作成され、別のウィンドウのラスター化のスタンドインです。これは、最上位のウィンドウまたは階層化された子ウィンドウである必要があります。 ウィンドウ ラッパーは概念的には、ウィンドウの内容が描画されるターゲット ウィンドウのサイズであるビットマップと同じです。 コンテンツには、ターゲット ウィンドウの子ウィンドウ (レイヤーまたはそれ以外の場合) と、子ウィンドウに描画される DirectComposition コンテンツが含まれます。

DirectComposition サーフェス ラッパーは CreateSurfaceFromHandle メソッドを使用して作成され、スワップ チェーンへの参照です。 あるプロセスがスワップ チェーンを作成し、別のプロセスがビットマップをビジュアルに関連付けるクロスプロセス シナリオでは、アプリケーションでサーフェス ラッパーを使用する場合があります。

ビットマップは常にビジュアルの座標系に対して位置 (0,0) に描画されますが、座標系は OffsetX、OffsetY、Transform プロパティの影響を直接受け、先祖ビジュアルの変換によって間接的に影響を受けます。 ビジュアルのビットマップは、常にそのビジュアルの子の背後に描画されます。

要件

こちらもご覧ください

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1