Antarmuka IMFVideoProcessor (evr9.h)

  • Artikel

Mengontrol pemrosesan video di Enhanced Video Renderer (EVR). Operasi yang dikontrol melalui antarmuka ini mencakup penyesuaian warna (ProcAmp), filter kebisingan, dan filter detail.

Mixer EVR mengimplementasikan antarmuka ini. Untuk mendapatkan penunjuk ke antarmuka, panggil IMFGetService::GetService. Pengidentifikasi layanan adalah guid MR_VIDEO_MIXER_SERVICE. Panggil GetService pada salah satu objek berikut:

  • Sesi media (jika topologi berisi instans EVR).
  • Sink media EVR.
  • Filter DirectShow EVR.
  • Mixer EVR.
Jika Anda menerapkan mixer kustom untuk EVR, mixer dapat secara opsional mengekspos antarmuka ini sebagai layanan.

Warisan

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

Metode

Antarmuka IMFVideoProcessor memiliki metode ini.

 
IMFVideoProcessor::GetAvailableVideoProcessorModes

Mengambil mode prosesor video yang didukung driver video.
IMFVideoProcessor::GetBackgroundColor

Mengambil warna latar belakang untuk persegi panjang komposisi. Warna latar belakang digunakan untuk kotak surat gambar video.
IMFVideoProcessor::GetFilteringRange

Mengambil rentang nilai untuk pengaturan filter gambar tertentu.
IMFVideoProcessor::GetFilteringValue

Mengambil pengaturan saat ini untuk filter gambar.
IMFVideoProcessor::GetProcAmpRange

Mengambil rentang nilai untuk pengaturan penyesuaian warna (ProcAmp).
IMFVideoProcessor::GetProcAmpValues

Mengambil pengaturan saat ini untuk satu atau beberapa pengaturan penyesuaian warna (ProcAmp).
IMFVideoProcessor::GetVideoProcessorCaps

Mengambil kemampuan mode prosesor video.
IMFVideoProcessor::GetVideoProcessorMode

Mengambil mode prosesor video pilihan aplikasi. Untuk mengatur mode pilihan, panggil IMFVideoProcessor::SetVideoProcessorMode.
IMFVideoProcessor::SetBackgroundColor

Mengatur warna latar belakang untuk persegi panjang komposisi. Warna latar belakang digunakan untuk kotak surat gambar video.
IMFVideoProcessor::SetFilteringValue

Mengatur parameter untuk filter gambar.
IMFVideoProcessor::SetProcAmpValues

Menyetel satu atau beberapa pengaturan penyesuaian warna (ProcAmp).
IMFVideoProcessor::SetVideoProcessorMode

Mengatur mode prosesor video pilihan. EVR akan mencoba menggunakan mode ini ketika pemutaran dimulai.

Keterangan

Antarmuka ini menyediakan akses ke fungsionalitas yang diimplementasikan oleh driver grafis. Driver menyediakan satu atau beberapa mode prosesor video, yang diidentifikasi oleh GUID. Setiap mode memiliki serangkaian kemampuannya sendiri. Daftar mode yang tersedia mungkin berubah tergantung pada jenis media video.

Untuk menggunakan antarmuka ini, lakukan langkah-langkah berikut:

  1. Menginisialisasi jenis media pada aliran input EVR. (Jika Anda menggunakan Sesi Media, ini terjadi setelah topologi diselesaikan. Tunggu Hingga Sesi Media mengirim peristiwa MESessionTopologyStatus dengan nilai status MF_TOPOSTATUS_READY.)
  2. Panggil IMFVideoProcessor::GetAvailableVideoProcessorModes untuk mendapatkan daftar mode prosesor video yang tersedia.
  3. Panggil IMFVideoProcessor::GetVideoProcessorCaps untuk menemukan kemampuan setiap mode prosesor video.
  4. Panggil IMFVideoProcessor::SetVideoProcessorMode untuk memilih mode. Jika Anda melewati langkah ini, EVR secara otomatis memilih mode prosesor video saat streaming dimulai. Dalam hal ini, tunggu pemutaran dimulai sebelum melanjutkan ke langkah 5.
  5. Panggil IMFVideoProcessor::GetProcAmpRange dan IMFVideoProcessor::GetFilteringRange untuk menemukan rentang nilai untuk berbagai procAmp dan pengaturan filter gambar.
  6. Panggil IMFVideoProcessor::SetProcAmpValues dan IMFVideoProcessor::SetFilteringValue untuk mengubah pengaturan ProcAmp dan filter gambar.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header evr9.h

Lihat juga

Perender Video yang Disempurnakan

Antarmuka Media Foundation