Metode IDvdGraphBuilder::GetDvdInterface (strmif.h)

Artikel
07/28/2023

[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 GetDvdInterface mengambil antarmuka dari grafik pemutaran DVD-Video untuk membuat pengembangan pemutaran DVD-Video lebih mudah.

Sintaks

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

Parameter

[in] riid

IID antarmuka yang diminta.

[out] ppvIF

Menerima penunjuk ke antarmuka. Aplikasi harus merilis antarmuka.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter ppvIF tidak valid. Parameter ini tidak boleh NULL.
E_NOINTERFACE	Antarmuka yang diminta tidak dapat dikembalikan.
VFW_E_DVD_GRAPHNOTREADY	Grafik belum dibangun. Lihat Keterangan.

Keterangan

Anda dapat menggunakan metode ini untuk memilih dan mengonfigurasi filter perender video sebelum membuat grafik filter untuk pemutaran DVD. Antarmuka berikut tersedia:

Filter Mixer Overlay: IDDrawExclModeVideo.
Video Mixing Renderer 7 (VMR-7): IVMRFilterConfig, IVMRMixerBitmap, IVMRWindowlessControl, dan IVMRMonitorConfig.
Video Mixing Renderer 9 (VMR-9): IVMRFilterConfig9, IVMRMixerBitmap9, IVMRWindowlessControl9, dan IVMRMonitorConfig9.
Enhanced Video Renderer (EVR): IEVRFilterConfig dan IMFVideoRenderer. Windows Server 2003, Windows XP, dan Windows 2000: Antarmuka ini tidak didukung.

Jika Anda memanggil GetDvdInterface untuk mendapatkan salah satu antarmuka ini sebelum Anda membangun grafik filter, DVD Graph Builder membuat perender video yang sesuai. Ini akan menggunakan perender ini nanti ketika Anda membangun grafik. Setelah perender video dipilih, Anda tidak dapat lagi mengambil antarmuka untuk perender video lainnya. (Metode GetDvdInterface akan mengembalikan E_NOINTERFACE.)

Sebelum grafik pemutaran DVD dibuat, jika Anda meminta antarmuka apa pun yang tidak ada di daftar sebelumnya, metode akan mengembalikan VFW_E_DVD_GRAPHNOTREADY. Untuk membangun grafik DVD, panggil IDvdGraphBuilder::RenderDvdVideoVolume. Setelah membuat grafik, Anda dapat menggunakan GetDvdInterface untuk mengambil beberapa antarmuka tambahan:

IDvdControl (tidak digunakan lagi), IDvdControl2, IDvdInfo (tidak digunakan lagi), dan IDvdInfo2 untuk mengontrol pemutaran DVD.
IVideoWindow, IBasicVideo, dan IBasicVideo2 untuk mengontrol pengaturan video, hanya dalam mode berjendela.
IBasicAudio untuk mengontrol pengaturan audio.
IAMLine21Decoder untuk mengontrol tampilan caption tertutup.
IMixerPinConfig dan IMixerPinConfig2 untuk mengonfigurasi pin input pertama filter Overlay Mixer, yang memberikan aliran video utama. (Untuk mendapatkan antarmuka ini untuk pin lain pada Overlay Mixer, hitung pin filter dan kueri secara langsung.) Aplikasi baru harus menghindari penggunaan filter Overlay Mixer.

Untuk mendapatkan antarmuka lain, panggil IDvdGraphBuilder::GetFiltergraph. Kueri antarmuka IGraphBuilder yang dikembalikan atau gunakan EnumFilters untuk menghitung filter.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Aplikasi DVD

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdGraphBuilder

Bagikan melalui