Bagikan melalui


Metode IDvdControl2::SetSubpictureState (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 SetSubpictureState mengaktifkan atau menonaktifkan tampilan subgambar.

Sintaks

HRESULT SetSubpictureState(
  [in]  BOOL    bState,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parameter

[in] bState

Nilai Boolean yang menentukan apakah tampilan subgambar aktif; TRUE menetapkan subgambaran ditampilkan pada untuk pemutaran berikutnya.

[in] dwFlags

Bitwise ATAU 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.
VFW_E_DVD_INVALIDDOMAIN
Navigator DVD berada di domain First Play.
VFW_E_DVD_OPERATION_INHIBITED
Kontrol UOP melarang operasi.

Keterangan

Aliran subgambar biasanya digunakan dalam menu untuk teks tombol dan terkadang grafik tombol, dan dalam pemutaran video untuk subtitel, kredit, atau grafik lain yang dilapisi. Jangan membingungkan subgambar dengan keterangan tertutup; yang terakhir dikodekan dalam aliran video. Secara umum, metode ini ditujukan untuk mengontrol tampilan subgambar melalui video saat filter Navigator DVD memutar video di domain Judul DVD.

Metode ini sesuai dengan parameter kedua dari perintah Annex J "Sub-picture_Stream_Change".

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
Sub-picture_stream_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

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

PilihSubpictureStream