IDvdInfo::Metode GetRoot (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.]

Catatan Antarmuka IDvdInfo tidak digunakan lagi. Gunakan IDvdInfo2 sebagai gantinya.

 

Mengambil direktori akar yang diatur dalam pemutar.

Sintaks

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

Parameter

[out] pRoot

Arahkan ke buffer untuk menerima string akar. Perhatikan bahwa string akar menggunakan karakter ANSI.

[in] ulBufSize

Ukuran buffer yang diteruskan, dalam byte.

[out] pulActualSize

Penunjuk ke nilai yang berisi ukuran data aktual yang dikembalikan.

Nilai kembali

Mengembalikan nilai HRESULT .

Menampilkan kode	Deskripsi
E_UNEXPECTED	DVD tidak diinisialisasi atau domain tidak DVD_DOMAIN_Title.
S_OK	Berhasil.
VFW_E_DVD_INVALIDDOMAIN	Tindakan yang diminta tidak didukung pada domain ini (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED	Tindakan yang diminta tidak dapat terjadi pada titik ini di dalam film karena penulisan cakram DVD-Video saat ini.

Keterangan

Jika akar yang valid ditemukan, metode ini mengembalikan string akar. Jika tidak, ini mengembalikan nol untuk pcbActualSize, yang menunjukkan bahwa direktori akar yang valid belum ditemukan atau diinisialisasi.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IDvdInfo