IMFContentProtectionManager::BeginEnableContent method (mfidl.h)

Artikel
02/28/2024

Memulai permintaan asinkron untuk melakukan tindakan pengaktifan konten.

Metode ini meminta aplikasi untuk melakukan langkah tertentu yang diperlukan untuk memperoleh hak atas konten, menggunakan objek pengaktif konten.

Sintaks

HRESULT BeginEnableContent(
  [in] IMFActivate      *pEnablerActivate,
  [in] IMFTopology      *pTopo,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parameter

[in] pEnablerActivate

Penunjuk ke antarmuka IMFActivate dari objek pengaktif konten. Untuk membuat pengaktif konten, panggil IMFActivate::ActivateObject dan minta antarmuka IMFContentEnabler . Aplikasi harus menggunakan metode di IMFContentEnabler untuk menyelesaikan tindakan pengaktifan konten.

[in] pTopo

Penunjuk ke antarmuka IMFTopology dari topologi yang tertunda.

[in] pCallback

Penunjuk ke antarmuka IMFAsyncCallback dari objek panggilan balik. Ketika operasi selesai, aplikasi harus memanggil IMFAsyncCallback::Invoke pada panggilan balik.

[in] punkState

Dicadangkan. Saat ini parameter ini selalu NULL.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Jangan blokir dalam metode panggilan balik ini. Sebagai gantinya, lakukan konten yang memungkinkan tindakan secara asinkron pada utas lain. Setelah operasi selesai, beri tahu jalur media yang dilindungi (PMP) melalui parameter pCallback .

Jika Anda mengembalikan kode keberhasilan dari metode ini, Anda harus memanggil Panggil pada panggilan balik. Sebaliknya, jika Anda mengembalikan kode kesalahan dari metode ini, Anda tidak boleh memanggil Invoke. Jika operasi gagal setelah metode mengembalikan kode keberhasilan, gunakan kode status pada objek IMFAsyncResult untuk melaporkan kesalahan.

Setelah panggilan balik dipanggil, PMP akan memanggil metode IMFContentProtectionManager::EndEnableContent aplikasi untuk menyelesaikan panggilan asinkron.

Metode ini belum tentu dipanggil setiap kali aplikasi memainkan konten yang dilindungi. Umumnya, metode tidak akan dipanggil jika pengguna memiliki lisensi konten yang valid dan terbaru. Secara internal, otoritas kepercayaan input (ITA) menentukan apakah BeginEnableContent dipanggil, berdasarkan kebijakan DRM penyedia konten. Untuk informasi selengkapnya, lihat Jalur Media Terproteksi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFActivate

IMFContentProtectionManager

Bagikan melalui