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

[アーティクル]
08/23/2023

この効果グループが適用されるビジュアルのラスター化を変更する 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