METODE IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS (mfidl.h)

Mendaftarkan antrean kerja topologi dengan Layanan Penjadwal Kelas Multimedia (MMCSS).

Sintaks

HRESULT BeginRegisterTopologyWorkQueuesWithMMCSS(
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Parameter

[in] pCallback

Penunjuk ke antarmuka IMFAsyncCallback dari objek panggilan balik. Pemanggil harus mengimplementasikan antarmuka ini.

[in] pState

Penunjuk ke antarmuka IUnknown dari objek status yang ditentukan oleh pemanggil. Parameter ini bisa NULL. Anda dapat menggunakan objek ini untuk menyimpan informasi status. Objek dikembalikan ke pemanggil ketika panggilan balik dipanggil.

Mengembalikan nilai

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

Keterangan

Setiap simpul sumber dalam topologi mendefinisikan satu cabang topologi. Cabang ini mencakup setiap simpul topologi yang menerima data dari simpul tersebut. Aplikasi dapat menetapkan setiap cabang topologi antrean kerjanya sendiri dan kemudian mengaitkan antrean kerja tersebut dengan tugas MMCSS.

Untuk menggunakan metode ini, lakukan langkah-langkah berikut.

1. Buat topologi.
2. Atur atribut berikut pada simpul sumber dalam topologi.
   • MF_TOPONODE_WORKQUEUE_ID. Menentukan pengidentifikasi untuk antrean kerja. Sesi Media akan mengalokasikan antrean kerja baru.
   • MF_TOPONODE_WORKQUEUE_MMCSS_CLASS. Menentukan kelas MMCSS.
   • MF_TOPONODE_WORKQUEUE_MMCSS_TASKID. Menentukan pengidentifikasi tugas MMCSS (opsional). Jika atribut ini tidak diatur, MMCSS menetapkan pengidentifikasi tugas baru.
3. Antrekan topologi dengan memanggil IMFMediaSession::SetTopology.
4. Tunggu peristiwa MESessionTopologyStatus dengan status MF_TOPOSTATUS_READY .
5. Panggil BeginRegisterTopologyWorkQueuesWithMMCSS. Metode ini mendaftarkan semua antrean kerja topologi dengan MMCSS.

Metode BeginRegisterTopologyWorkQueuesWithMMCSS bersifat asinkron. Ketika operasi selesai, metode IMFAsyncCallback::Invoke objek panggilan dipanggil. Dalam metode panggilan balik, panggil IMFWorkQueueServices::EndRegisterTopologyWorkQueuesWithMMCSS untuk menyelesaikan permintaan asinkron. Setelah operasi ini selesai, Sesi Media secara otomatis mendaftarkan antrean kerja untuk setiap topologi baru yang diantrekan pada Sesi Media. Aplikasi tidak perlu memanggil metode lagi untuk topologi baru.

Untuk membatalkan pendaftaran antrean kerja topologi dari MMCSS, panggil IMFWorkQueueServices::BeginUnregisterTopologyWorkQueuesWithMMCSS.

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

IMFWorkQueueServices