次の方法で共有


IDCompositionEffectGroup::SetTransform3D メソッド (dcomp.h)

この効果グループが適用されるビジュアルのラスター化を変更する 3D 変換効果オブジェクトを設定します。

構文

HRESULT SetTransform3D(
  [in, optional] IDCompositionTransform3D *transform3D
);

パラメーター

[in, optional] transform3D

型: IDCompositionTransform3D*

IDCompositionTransform3D インターフェイスまたはその派生インターフェイスへのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

型: HRESULT

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

注釈

transform3D が無効なポインターである場合、またはポインターがこの効果グループと同じ IDCompositionDevice インターフェイスによって作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。

transform3D パラメーターが NULL の場合、効果グループはビジュアルにパースペクティブ変換を適用しません。 変換を NULL に設定することは、指定された行列が ID 行列である IDCompositionMatrixTransform3D オブジェクトに変換を設定することと同じです。 ただし、アプリケーションでは、少し高速であるため、可能な限り NULL 変換を使用する必要があります。

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dcomp.h
Library Dcomp.lib
[DLL] Dcomp.dll

こちらもご覧ください

IDCompositionEffectGroup

IDCompositionMatrixTransform3D

IDCompositionRotateTransform3D

IDCompositionScaleTransform3D

IDCompositionTransform3D

IDCompositionTranslateTransform3D