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 相當於將轉換設定為 IDCompositionMatrixTransform3D 物件,其中指定的矩陣是識別矩陣。 不過,應用程式應該盡可能使用 NULL 轉換,因為它稍微快一點。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionEffectGroup

IDCompositionMatrixTransform3D

IDCompositionRotateTransform3D

IDCompositionScaleTransform3D

IDCompositionTransform3D

IDCompositionTranslateTransform3D