IDvdControl2::Metode ShowMenu (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.]

Metode ShowMenu ini menampilkan menu yang ditentukan, jika tersedia.

Sintaks

HRESULT ShowMenu(
  [in]  DVD_MENU_ID MenuID,
  [in]  DWORD       dwFlags,
  [out] IDvdCmd     **ppCmd
);

Parameter

[in] MenuID

Nilai enumerasi DVD_MENU_ID yang menentukan menu yang akan ditampilkan.

[in] dwFlags

Bitwise OR dari satu atau beberapa bendera dari enumerasi DVD_CMD_FLAGS , menentukan cara menyinkronkan perintah.

[out] ppCmd

Menerima penunjuk ke objek IDvdCmd yang dapat digunakan untuk menyinkronkan perintah DVD. Pemanggil harus merilis antarmuka. Parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Menyinkronkan Perintah DVD.

Mengembalikan nilai

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Parameter MenuID tidak valid.
VFW_E_DVD_INVALIDDOMAIN	Domain tidak valid.
VFW_E_DVD_MENU_DOES_NOT_EXIST	Menu yang ditentukan tidak ada.
VFW_E_DVD_OPERATION_INHIBITED	Kontrol UOP melarang operasi.

Keterangan

Menu Manajer Video (VMGM) harus dapat diakses dari domain Judul atau Kumpulan Judul Video. Menu Set Judul Video (VTSM) mungkin hanya dapat diakses melalui VMGM. Submenus apa pun di bawah setiap VTSM (untuk bab, sudut, dan aliran audio dan subgambar) hanya dapat diakses melalui VTSM tersebut.

Metode ini ditunjukkan dalam aplikasi DVDSample di CDvdCore::RootMenu dan CDvdCore::TitleMenu.

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
Menu_Call	Semua.

Persyaratan

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

Bekerja Dengan Menu DVD