Metode IDvdGraphBuilder::RenderDvdVideoVolume (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 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 |
---|---|
|
Parameter dwFlags menentukan opsi yang bertentangan. |
|
Metode ini berhasil sebagian. Untuk mengetahui kesalahan mana yang terjadi, periksa parameter pStatus . |
|
Metode berhasil, dan semua aliran dirender. |
|
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. |
|
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). |
|
Terjadi kesalahan saat membangun grafik. Misalnya, DVD Graph Builder tidak dapat membuat filter yang diperlukan atau tidak dapat merender aliran apa pun. |
|
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.
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 |