METODE ID2D1Factory1::RegisterEffectFromString (d2d1_1.h)

Artikel
08/22/2023

Mendaftarkan efek dalam instans pabrik dengan XML properti yang ditentukan sebagai string.

Sintaks

HRESULT RegisterEffectFromString(
  [in]           REFCLSID                    classId,
  [in]           PCWSTR                      propertyXml,
  [in, optional] const D2D1_PROPERTY_BINDING *bindings,
                 UINT32                      bindingsCount,
                 const PD2D1_EFFECT_FACTORY  effectFactory
);

Parameter

[in] classId

Jenis: REFCLSID

Pengidentifikasi efek yang akan didaftarkan.

[in] propertyXml

Jenis: PCWSTR

Daftar properti efek, jenis, dan metadata.

[in, optional] bindings

Jenis: const D2D1_PROPERTY_BINDING*

Array properti dan metode.

Ini mengikat properti berdasarkan nama ke metode tertentu yang diimplementasikan oleh penulis efek untuk menangani properti . Nama harus ditemukan di propertyXml yang sesuai.

bindingsCount

Jenis: UINT32

Jumlah pengikatan dalam array pengikatan.

effectFactory

Jenis: PD2D1_EFFECT_FACTORY

Pabrik statis yang digunakan untuk membuat efek yang sesuai.

Mengembalikan 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	Parameter yang tidak valid diteruskan ke fungsi pengembalian.

Keterangan

Efek Direct2D harus menentukan propertinya pada waktu pendaftaran melalui XML pendaftaran. Efek mendeklarasikan beberapa properti sistem yang diperlukan, dan juga dapat mendeklarasikan properti kustom. Lihat Efek kustom untuk informasi selengkapnya tentang memformat parameter propertyXml .

RegisterEffect adalah atomik dan referensi yang dihitung. Untuk membatalkan pendaftaran efek, panggil UnregisterEffect dengan classId efek.

RegisterEffect penting tidak menyimpan referensi ke DLL atau file yang dapat dieksekusi di mana efeknya terkandung. Aplikasi harus secara independen memastikan bahwa masa pakai DLL atau file yang dapat dieksekusi sepenuhnya berisi semua instans dari setiap efek yang terdaftar dan dibuat.

Selain efek bawaan yang terdaftar secara global, API ini mendaftarkan efek hanya untuk pabrik ini dan antarmuka konteks perangkat dan perangkat turunan.

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
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1Factory1

ID2D1Factory1::UnregisterEffect

Bagikan melalui