Metode IVMRMonitorConfig::SetMonitor (strmif.h)

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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.]

Pada sistem multi-monitor, SetMonitor metode menentukan monitor yang harus digunakan instans VMR ini untuk pemutaran video.

Sintaks

HRESULT SetMonitor(
  [in] const VMRGUID *pGUID
);

Parameter

[in] pGUID

Penunjuk ke struktur VMRGUID yang mengidentifikasi monitor.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Argumen tidak valid.
E_POINTER	Argumen pointer NULL.
S_OK	Berhasil.
VFW_E_WRONG_STATE	Alokator-presenter belum dimuat.

Keterangan

Gunakan metode ini pada sistem multi-monitor untuk menentukan ke VMR driver DirectDraw mana yang harus digunakan saat menyambungkan ke filter dekoder upstram.

Anggota pGUID dari struktur VMRGUID harus NULL, menunjukkan perangkat DirectDraw default, atau sama dengan alamat anggota GUID dari struktur VMRGUID . Jika tidak, metode mengembalikan E_INVALIDARG.

Jika GUID yang ditentukan tidak sesuai dengan monitor apa pun, metode akan mengembalikan E_INVALIDARG.

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 IVMRMonitorConfig

IVMRMonitorConfig::GetMonitor

Menggunakan Video Mixing Renderer