Bagikan melalui

Antarmuka IMFPluginControl (mfobjects.h)

  • Artikel

Mengontrol bagaimana sumber dan transformasi media dijumlahkan di Microsoft Media Foundation.

Untuk mendapatkan penunjuk ke antarmuka ini, panggil MFGetPluginControl.

Warisan

Antarmuka IMFPluginControl mewarisi dari antarmuka IUnknown . IMFPluginControl juga memiliki jenis anggota berikut:

Metode

Antarmuka IMFPluginControl memiliki metode ini.

 
IMFPluginControl::GetDisabledByIndex

IMFPluginControl::GetDisabledByIndex (mfobjects.h) mendapatkan pengidentifikasi kelas (CLSID) dari daftar yang diblokir.
IMFPluginControl::GetPreferredClsid

Mencari daftar pilihan untuk pengidentifikasi kelas (CLSID) yang cocok dengan nama kunci tertentu.
IMFPluginControl::GetPreferredClsidByIndex

Metode IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h) mendapatkan pengidentifikasi kelas (CLSID) dari daftar pilihan, yang ditentukan oleh nilai indeks.
IMFPluginControl::IsDisabled

Mengkueri apakah pengidentifikasi kelas (CLSID) muncul dalam daftar yang diblokir. (IMFPluginControl.IsDisabled)
IMFPluginControl::SetDisabled

Menambahkan pengidentifikasi kelas (CLSID) ke daftar yang diblokir, atau menghapus CLSID dari daftar. (IMFPluginControl.SetDisabled)
IMFPluginControl::SetPreferredClsid

Menambahkan pengidentifikasi kelas (CLSID) ke daftar pilihan atau menghapus CLSID dari daftar. (IMFPluginControl.SetPreferredClsid)

Keterangan

Media Foundation menyediakan sekumpulan sumber media dan dekode bawaan. Aplikasi dapat menghitungnya sebagai berikut:

Aplikasi mungkin juga menghitung objek ini secara tidak langsung. Misalnya, jika aplikasi menggunakan pemuat topologi untuk menyelesaikan topologi parsial, pemuat topologi memanggil MFTEnumEx untuk menemukan dekode yang diperlukan.

Pihak ketiga dapat menerapkan sumber dan dekode media kustom mereka sendiri, dan mendaftarkannya untuk enumerasi sehingga aplikasi lain dapat menggunakannya.

Untuk mengontrol urutan enumerasi, Media Foundation mempertahankan dua daftar CLSID di seluruh proses: daftar pilihan dan daftar yang diblokir. Objek yang CLSID-nya muncul dalam daftar pilihan muncul terlebih dahulu dalam urutan enumerasi. Objek yang CLSID-nya muncul di daftar yang diblokir tidak dijumlahkan.

Daftar awalnya diisi dari registri. Aplikasi dapat menggunakan antarmuka IMFPluginControl untuk mengubah daftar untuk proses saat ini.

Daftar yang disukai berisi sekumpulan pasangan kunci/nilai, di mana kuncinya adalah string dan nilainya adalah CLSID. Pasangan kunci/nilai ini didefinisikan sebagai berikut:

  • Untuk sumber media, nama kunci adalah ekstensi nama file, skema protokol, atau jenis MIME. Nilainya adalah CLSID dari handler skema atau byte-stream handler untuk sumber media tersebut.
  • Untuk dekode, nama kunci adalah GUID subjenis media dalam bentuk string kanonis. (Untuk informasi selengkapnya tentang subjenis media, lihat Jenis Media.) Nilainya adalah CLSID dari transformasi Media Foundation (MFT) yang mengimplementasikan dekoder.
Contoh berikut menunjukkan berbagai jenis kunci:
  • Ekstensi file: ".wmv"
  • Skema: "http:"
  • Jenis MIME: "video/mp4"
  • Subjenis media: "{47504A4D-0000-0010-8000-00AA00389B71}"
Untuk mencari daftar pilihan menurut nama kunci, panggil metode IMFPluginControl::GetPreferredClsid . Untuk menghitung seluruh daftar, panggil metode IMFPluginControl::GetPreferredClsidByIndex dalam perulangan.

Daftar yang diblokir berisi daftar CLSID. Untuk menghitung seluruh daftar, panggil metode IMFPluginControl::GetDisabledByIndex dalam perulangan. Untuk memeriksa apakah CLSID tertentu muncul dalam daftar, panggil metode IMFPluginControl::IsDisabled .

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header mfobjects.h (termasuk Mfidl.h)

Lihat juga

MFGetPluginControl

Antarmuka Media Foundation