Metode IVMRFilterConfig::SetRenderingPrefs (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode ini SetRenderingPrefs mengatur berbagai preferensi aplikasi yang terkait dengan penyajian video.

Sintaks

HRESULT SetRenderingPrefs(
  [in] DWORD dwRenderFlags
);

Parameter

[in] dwRenderFlags

Kata ganda yang berisi bitwise ATAU nilai VMRRenderPrefs yang menentukan preferensi penyajian.

Mengembalikan nilai

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan ditampilkan.

Menampilkan kode	Deskripsi
VFW_E_WRONG_STATE	Tidak ada alokator-penyaji.
E_INVALIDARG	dwRenderFlags tidak valid.

Keterangan

Metode ini memanggil melalui metode IVMRImagePresenterConfig::SetRenderingPrefs dari allocator-presenter. (Alokator-presenter default mengekspos IVMRImagePresenterConfig. Alokator-penyaji kustom juga dapat mengekspos antarmuka ini jika diinginkan.) Jika VMR-7 belum membuat alokator-presenter default, atau jika aplikasi menyediakan alokator-presenter kustom yang tidak mendukung IVMRImagePresenterConfig, metode ini mengembalikan VFW_E_WRONG_STATE. Untuk membuat alokator-presenter default, panggil IVMRFilterConfig::SetRenderingMode dengan nilai VMRMode_Windowed atau VMRMode_Windowed.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IVMRFilterConfig

IVMRFilterConfig::GetRenderingPrefs

Menggunakan Video Mixing Renderer