Fungsi MFCreatePMPMediaSession (mfidl.h)

Membuat instans Sesi Media di dalam proses Jalur Media Terproteksi (PMP).

Sintaks

HRESULT MFCreatePMPMediaSession(
  DWORD           dwCreationFlags,
  IMFAttributes   *pConfiguration,
  IMFMediaSession **ppMediaSession,
  IMFActivate     **ppEnablerActivate
);

Parameter

dwCreationFlags

Anggota enumerasi MFPMPSESSION_CREATION_FLAGS yang menentukan cara membuat objek sesi.

pConfiguration

Penunjuk ke antarmuka IMFAttributes . Parameter ini bisa NULL. Lihat Keterangan.

ppMediaSession

Menerima penunjuk ke antarmuka IMFMediaSession Sesi Media PMP. Pemanggil harus merilis antarmuka. Sebelum merilis referensi terakhir ke penunjuk IMFMediaSession , aplikasi harus memanggil metode IMFMediaSession::Shutdown .

ppEnablerActivate

Menerima penunjuk ke antarmuka IMFActivate atau nilai NULL. Jika non-NULL, pemanggil harus merilis antarmuka. Lihat Keterangan.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Fungsi berhasil.

Keterangan

Anda dapat menggunakan parameter pConfiguration untuk mengatur salah satu atribut berikut:

• MF_SESSION_CONTENT_PROTECTION_MANAGER
• MF_SESSION_GLOBAL_TIME
• MF_SESSION_QUALITY_MANAGER
• MF_SESSION_REMOTE_SOURCE_MODE
• MF_SESSION_SERVER_CONTEXT
• MF_SESSION_TOPOLOADER

Jika fungsi ini tidak dapat membuat Sesi Media PMP karena biner tepercaya dicabut, parameter ppEnablerActivate menerima penunjuk antarmuka IMFActivate . Aplikasi dapat menggunakan penunjuk ini untuk membuat objek pengaktif konten, yang kemudian dapat digunakan untuk mengunduh biner yang diperbarui:

1. Panggil IMFActivate::ActivateObject dengan pengidentifikasi antarmuka IID_IMFContentEnabler untuk mendapatkan penunjuk antarmuka IMFContentEnabler .
2. Gunakan antarmuka tersebut untuk mengunduh biner yang diperbarui.
3. Hubungi MFCreatePMPMediaSession lagi.

Jika fungsi berhasil membuat Sesi Media PMP, parameter ppEnablerActivate menerima nilai NULL.

Jangan melakukan panggilan ke Sesi Media PMP dari utas yang memproses pesan jendela yang dikirim dari utas lain. Untuk menguji apakah utas saat ini termasuk dalam kategori ini, panggil InSendMessage.

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	mfidl.h
Pustaka	Mf.lib
DLL	Mf.dll

Lihat juga

MFCreateMediaSession

Fungsi Media Foundation

Sesi Media PMP

Jalur Media Terproteksi