Metode IDvdGraphBuilder::RenderDvdVideoVolume (strmif.h)

Artikel
03/02/2024

[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 RenderDvdVideoVolume ini selesai membangun grafik filter sesuai dengan spesifikasi pengguna untuk memutar volume DVD-Video.

Sintaks

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Parameter

[in] lpcwszPathName

Arahkan ke jalur agar volume DVD-Video diputar. Bisa NULL.

[in] dwFlags

Bitwise ATAU bendera dari enumerasi AM_DVD_GRAPH_FLAGS , menentukan cara membuat grafik pemutaran DVD.

[out] pStatus

Penunjuk ke struktur AM_DVD_RENDERSTATUS . Ketika metode kembali, struktur menunjukkan kegagalan penyajian apa pun.

Mengembalikan nilai

Mengembalikan nilai HRESULT yang bergantung pada implementasi antarmuka. Nilai pengembalian implementasi DirectShow meliputi yang berikut ini:

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter dwFlags menentukan opsi yang bertentangan.
S_FALSE	Metode ini berhasil sebagian. Untuk mengetahui kesalahan mana yang terjadi, periksa parameter pStatus .
S_OK	Metode berhasil, dan semua aliran dirender.
VFW_E_DVD_DECNOTENOUGH	Satu atau beberapa aliran tidak dapat dirender. Jika Anda menentukan bendera AM_DVD_HWDEC_ONLY atau AM_DVD_SWDEC_ONLY di parameter dwFlags , coba panggil metode lagi dengan bendera AM_DVD_HWDEC_PREFER atau AM_DVD_SWDEC_PREFER.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH	Grafik filter sudah berisi perender video. Metode mengembalikan kode kesalahan ini jika Anda menentukan bendera AM_DVD_EVR_ONLY di parameter dwFlags tetapi grafik sudah berisi penyaji video selain filter Enhanced Video Renderer (VMR).
VFW_E_DVD_RENDERFAIL	Terjadi kesalahan saat membangun grafik. Misalnya, DVD Graph Builder tidak dapat membuat filter yang diperlukan atau tidak dapat merender aliran apa pun.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH	Grafik filter berisi lebih dari satu perender video.

Keterangan

Struktur AM_DVD_RENDERSTATUS mencerminkan kode kegagalan untuk metode ini. Alasan metode ini mengembalikan S_FALSE meliputi hal berikut:

Grafik telah dibangun sepenuhnya, tetapi salah satu hal berikut ini benar.
- Pencampuran overlay tidak berfungsi—aplikasi tidak mengatur bendera AM_DVD_NOVPE dan aliran video tidak dapat dimasukkan melalui Overlay Mixer. Dalam hal ini, jika video didekodekan dalam perangkat lunak, aplikasi akan memiliki informasi yang cukup untuk memberi tahu pengguna bahwa video tidak akan terlihat. Video yang didekodekan perangkat keras hanya akan terlihat di TV yang terhubung ke port keluar NTSC dari dekoder video perangkat keras.
- Dekoder video tidak menghasilkan data baris 21. Aplikasi dapat menampilkan pesan peringatan atau informatif bahwa teks tertutup tidak tersedia karena dekoder.
- Tidak ada jalur volume yang ditentukan dan DVD Navigator tidak menemukan volume DVD-Video yang akan diputar. Aplikasi dapat meminta pengguna untuk memasukkan disk DVD-Video jika tidak ada yang tersedia di drive saat pemutaran dimulai.
Beberapa aliran tidak dirender. Aplikasi dapat menunjukkan kepada pengguna bahwa beberapa aliran tidak dapat diputar.

Metode ini membangun grafik tanpa pengetahuan tentang file atau volume DVD-Video untuk diputar. Penyusun grafik DVD-Video membangun grafik meskipun lpcwszPathName adalah NULL atau jika filter Navigator DVD tidak menemukan volume DVD-Video default untuk diputar.

Persyaratan

Persyaratan	Nilai
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