Metode IVMRMonitorConfig::SetDefaultMonitor (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.]

Metode SetDefaultMonitor menentukan monitor default yang harus digunakan semua instans VMR di masa mendatang untuk pemutaran video.

Sintaks

HRESULT SetDefaultMonitor(
  [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_FAIL	Tidak dapat mengatur monitor yang ditentukan sebagai default.
E_INVALIDARG	Argumen tidak valid. Monitor yang ditentukan tidak ada, atau parameter pGUID tidak diformat dengan benar.
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 perangkat DirectDraw default untuk digunakan saat menyambungkan ke filter upstram. Perangkat DirectDraw default dapat ditimpa untuk koneksi tertentu dengan metode SetMonitor .

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

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::GetDefaultMonitor

Menggunakan Video Mixing Renderer