METODE IDCompositionEffectGroup::SetTransform3D (dcomp.h)

Artikel
02/29/2024

Mengatur objek efek transformasi 3D yang memodifikasi rasterisasi visual tempat grup efek ini diterapkan.

Sintaks

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

Parameter

[in, optional] transform3D

Jenis: IDCompositionTransform3D*

Penunjuk ke antarmuka IDCompositionTransform3D atau salah satu antarmuka turunannya. Parameter ini bisa NULL.

Nilai kembali

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Metode ini gagal jika transform3D adalah penunjuk yang tidak valid, atau jika penunjuk tidak dibuat oleh antarmuka IDCompositionDevice yang sama dengan grup efek ini. Antarmuka tidak boleh menjadi implementasi kustom; hanya antarmuka yang dibuat oleh Microsoft DirectComposition yang dapat digunakan dengan metode ini.

Jika parameter transform3D ADALAH NULL, grup efek tidak menerapkan transformasi perspektif apa pun ke visual. Mengatur transformasi ke NULL setara dengan mengatur transformasi ke objek IDCompositionMatrixTransform3D di mana matriks yang ditentukan adalah matriks identitas. Namun, aplikasi harus menggunakan transformasi NULL jika memungkinkan karena sedikit lebih cepat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	dcomp.h
Pustaka	Dcomp.lib
DLL	Dcomp.dll