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.
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 |