METODE IMFActivate::ActivateObject (mfobjects.h)

Membuat objek yang terkait dengan objek aktivasi ini.

Sintaks

HRESULT ActivateObject(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] riid

Pengidentifikasi antarmuka (IID) dari antarmuka yang diminta.

[out] ppv

Menerima penunjuk ke antarmuka yang diminta. Pemanggil harus merilis antarmuka.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Beberapa objek Microsoft Media Foundation harus dimatikan sebelum dirilis. Jika demikian, penelepon bertanggung jawab untuk mematikan objek yang dikembalikan dalam ppv. Untuk mematikan objek, lakukan salah satu hal berikut ini:

• Panggil IMFActivate::ShutdownObject pada objek aktivasi, atau
• Panggil metode matikan khusus objek. Metode ini akan bergantung pada jenis objek. Beberapa kemungkinan mencakup:
  • Sumber media: Panggil IMFMediaSource::Shutdown.
  • Sink media: Panggil IMFMediaSink::Shutdown.
  • Objek apa pun yang mendukung antarmuka IMFShutdown : Panggil IMFShutdown::Shutdown.

Metode IMFActivate::ShutdownObject umum untuk semua jenis objek. Jika objek tidak memerlukan metode matikan, ShutdownObject berhasil dan tidak berpengaruh. Jika Anda tidak tahu metode matikan khusus untuk objek (atau tidak tahu jenis objek), panggil IMFActivate::ShutdownObject.

Setelah panggilan pertama ke ActivateObject, panggilan berikutnya mengembalikan penunjuk ke instans yang sama, hingga klien memanggil ShutdownObject atau IMFActivate::D etachObject.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	mfobjects.h
Pustaka	Mfuuid.lib

Lihat juga

Objek Aktivasi

IMFActivate