METODE ID2D1DeviceContext::CreateEffect (d2d1_1.h)

Membuat efek untuk ID kelas yang ditentukan.

Sintaks

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

Parameter

effectId

Jenis: REFCLSID

ID kelas efek yang akan dibuat. Lihat Efek Bawaan untuk daftar ID efek.

[out] effect

Jenis: ID2D1Effect**

Ketika metode ini kembali, berisi alamat penunjuk ke efek baru.

Menampilkan nilai

Jenis: HRESULT

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

HRESULT	Deskripsi
S_OK	Tidak terjadi kesalahan.
E_OUTOFMEMORY	Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan.
E_INVALIDARG	Nilai yang tidak valid diteruskan ke metode .
D3DERR_OUTOFVIDEOMEMORY	Direct3D tidak memiliki cukup memori tampilan untuk melakukan operasi.
D2DERR_EFFECT_IS_NOT_REGISTERED	Efek yang ditentukan tidak didaftarkan oleh sistem.
E_NOTFOUND	Kemungkinan HRESULT lain untuk efek yang tidak didaftarkan (seperti D2DERR_EFFECT_IS_NOT_REGISTERED).
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES	Efeknya memerlukan kemampuan yang tidak didukung oleh perangkat D2D.

Keterangan

Jika efek yang dibuat adalah efek kustom yang diterapkan dalam DLL, ini tidak menaikkan jumlah referensi untuk DLL tersebut. Jika aplikasi menghapus efek saat efek tersebut dimuat, perilaku yang dihasilkan tidak dapat diprediksi.

Persyaratan

Klien minimum yang didukung	Pembaruan Windows 8 dan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	d2d1_1.h
DLL	D2d1.dll

Lihat juga

Efek

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect