Bagikan melalui


Metode ID2D1Factory1::GetEffectProperties (d2d1_1.h)

Mengambil properti efek.

Sintaks

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Parameter

[in] effectId

Jenis: REFCLSID

ID efek untuk mengambil properti.

[out] properties

Jenis: ID2D1Properties**

Ketika metode ini kembali, berisi alamat penunjuk ke antarmuka properti yang dapat digunakan untuk mengkueri metadata efek.

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.
D2DERR_EFFECT_IS_NOT_REGISTERED Efek yang diminta tidak dapat ditemukan.
E_OUTOFMEMORY Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan.

Keterangan

Properti efek yang dikembalikan akan memiliki semua properti yang dapat diubah untuk efek yang diatur ke default NULL, atau nilai kosong.

  • Jenis nilai akan diisi nol.
  • Jenis blob dan string akan menjadi panjang nol.
  • Jenis array akan memiliki panjang 1 dan elemen array akan sesuai dengan aturan sebelumnya.
Metode ini tidak dapat digunakan untuk mengembalikan properti untuk efek apa pun yang tidak terlihat oleh ID2D1DeviceContext::CreateEffect.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 dan Pembaruan 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::GetRegisteredEffects

ID2D1Factory1::RegisterEffect