Metode IDvdControl2::SetDVDDirectory (strmif.h)

Artikel
07/28/2023

[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 ini SetDVDDirectory mengatur drive DVD yang akan dibaca filter Navigator DVD .

Sintaks

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

Parameter

[in] pszwPath

Penunjuk ke string karakter lebar yang menentukan jalur direktori akar.

Nilai kembali

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Parameter pszwPath menunjuk ke jalur DVD yang tidak valid, atau drive DVD tidak ditemukan saat menghitung.
E_UNEXPECTED	Navigator DVD tidak diinisialisasi.
VFW_E_DVD_INVALIDDOMAIN	Domain tidak valid. Untuk detailnya, lihat Keterangan.

Keterangan

Jika pszwPathADALAH NULL, Navigator DVD mencoba memilih volume DVD pada drive yang tersedia. Saat memulai, DVD Navigator secara otomatis mencari drive, dimulai dari drive C, dengan folder VIDEO_TS di folder akar. Oleh karena itu, Anda hanya perlu memanggil SetDVDDirectory ketika Anda memiliki lebih dari satu drive DVD pada mesin, atau jika huruf drive DVD Anda adalah A atau B. Saat menentukan jalur, sertakan folder video_ts.

C++
SetDVDDirectory(L"e:\\video_ts");

Beberapa volume DVD mungkin memiliki videonya dalam direktori bernama selain "video_ts." Ide umumnya adalah bahwa "volume DVD" tambahan (satu set . JIKAO. VOB, dan . File BUP yang biasanya akan disimpan di direktori VIDEO_TS) dapat ditempatkan dalam subdirektori pada disk. Dengan mengubah root untuk menunjuk ke direktori ini, MSWebDVD akan beroperasi pada volume DVD terpisah ini. Sekumpulan menu, judul, dan sebagainya baru akan tersedia, terlepas dari judul di akar VIDEO_TS, yang tidak akan lagi dapat diakses. Direktori semacam itu disebut "direktori tersembunyi." Contoh berikut menunjukkan cara mengatur direktori tersembunyi sebagai akar, di mana "tersembunyi" adalah tempat penampung untuk nama apa pun yang telah diberikan penulis disk ke direktori.

C++
SetDVDDirectory(L"d:\\webdvd\\hidden");

Jika grafik filter berjalan dan DVD Navigator menemukan DVD di direktori yang ditentukan oleh pszwPath, Navigator DVD secara otomatis mulai memutar disk. Ini sesuai dengan spesifikasi DVD dan memastikan bahwa diska baru diinisialisasi dengan benar. Jika Anda tidak ingin disk baru diputar secara otomatis setelah SetDVDDirectory pengembalian, Anda harus mengatur bendera DVD_ResetOnStop di IDvdControl2::SetOption ke TRUE dan menghentikan grafik filter melalui panggilan ke IMediaControl::Stop pada Filter Graph Manager. Jika DVD_ResetOnStop diatur ke FALSE, maka SetDVDDirectory mengembalikan VFW_E_DVD_INVALIDDOMAIN.

Metode ini ditunjukkan dalam aplikasi DVDSample di CDvdCore::SetDirectory.

Tabel berikut ini memperlihatkan nama perintah Annex J yang sesuai dengan nama metode ini, dan domain di mana metode ini valid.

Nama Perintah Annex J	Domain yang Valid
Tidak ada	DVD_DOMAIN_Stop

Persyaratan


Klien minimum yang didukung	Windows XP [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

Aplikasi DVD

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdControl2

Bagikan melalui