IDvdControl2::SelectAudioStream method (strmif.h)

Artikel
03/13/2024

[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 SelectAudioStream memilih aliran audio untuk diputar.

Sintaks

HRESULT SelectAudioStream(
  [in]  ULONG   ulAudio,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parameter

[in] ulAudio

Nilai yang menentukan aliran audio. Nomor streaming yang valid adalah 0 hingga 7, atau DVD_DEFAULT_AUDIO_STREAM untuk menentukan aliran default.

[in] dwFlags

Bitwise OR dari satu atau beberapa bendera dari enumerasi DVD_CMD_FLAGS , menentukan cara menyinkronkan perintah. Parameter ini saat ini diabaikan; gunakan DVD_CMD_FLAG_None.

[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_FALSE	Tidak ada aliran audio default yang ditemukan; atau dwFlags bukan nol.
S_OK	Berhasil.
E_INVALIDARG	ulAudio berada di luar jangkauan, atau tidak sesuai dengan aliran audio.
E_UNEXPECTED	Nilai ulAudio valid, tetapi Navigator DVD tidak dapat mengaturnya karena alasan tertentu.
VFW_E_DVD_OPERATION_INHIBITED	Kontrol UOP melarang operasi.
VFW_E_DVD_STREAM_DISABLED	Aliran yang ditentukan dinonaktifkan.

Keterangan

Metode ini memengaruhi audio Kumpulan Judul Video (VTS) saat ini. Ketika dipanggil dari dalam menu, metode ini mengatur aliran audio judul tempat menu dipanggil.

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
Audio_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

Bagikan melalui