Metode ID2D1Factory1::GetRegisteredEffects (d2d1_1.h)

Mengembalikan ID kelas dari efek yang saat ini terdaftar dan efek global pada pabrik ini.

Sintaks

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

Parameter

[out] effects

Jenis: CLSID*

Ketika metode ini kembali, berisi array efek. NULL jika tidak ada efek yang diambil.

effectsCount

Jenis: UINT32

Kapasitas array efek .

[out] effectsReturned

Jenis: UINT32*

Ketika metode ini kembali, berisi jumlah efek yang disalin ke dalam efek.

[out, optional] effectsRegistered

Jenis: UINT32*

Ketika metode ini kembali, berisi jumlah efek yang saat ini terdaftar dalam sistem.

Nilai kembali

Jenis: HRESULT

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

HRESULT	Deskripsi
S_OK	Tidak ada kesalahan yang terjadi.
E_OUTOFMEMORY	Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	effectsRegistered lebih besar dari effectCount.

Keterangan

Kumpulan ID kelas akan dikembalikan secara atomik oleh API. Set tidak akan terganggu oleh utas lain yang mendaftar atau membatalkan pendaftaran efek.

Jika effectsRegistered lebih besar dari effectCount, array yang disediakan masih akan diisi ke kapasitas dengan set efek terdaftar saat ini. Metode ini mengembalikan CLSID untuk semua efek global dan semua efek yang terdaftar di pabrik ini.

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 Pembaruan Platform 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::RegisterEffect