METODE IMFSourceReader::SetStreamSelection (mfreadwrite.h)

Memilih atau membatalkan pilihan satu atau beberapa aliran.

Syntax

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Parameter-parameternya

[in] dwStreamIndex

Aliran yang akan diatur. Nilainya bisa salah satu dari yang berikut ini.

Nilai	Meaning
0–0xFFFFFFFB	Indeks aliran berbasis nol.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Streaming video pertama.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Aliran audio pertama.
MF_SOURCE_READER_ALL_STREAMS 0xFFFFFFFE	Semua aliran.

[in] fSelected

Tentukan TRUE untuk memilih aliran atau FALSE untuk membatalkan pilihan aliran. Jika aliran tidak dipilih, aliran tidak akan menghasilkan data.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

Ada dua penggunaan umum untuk metode ini:

• Untuk mengubah pilihan aliran default. Beberapa file media berisi beberapa aliran dengan jenis yang sama. Misalnya, file mungkin menyertakan aliran audio untuk beberapa bahasa. Anda dapat menggunakan metode ini untuk mengubah aliran mana yang dipilih. Untuk mendapatkan informasi tentang setiap aliran, panggil IMFSourceReader::GetPresentationAttribute atau IMFSourceReader::GetNativeMediaType.
• Jika Anda tidak akan memerlukan data dari salah satu aliran, ada baiknya untuk membatalkan pilihan aliran tersebut. Jika aliran dipilih, sumber media mungkin menyimpan antrean data yang belum dibaca, dan antrean mungkin tumbuh tanpa batas waktu, mengonsumsi memori.

Untuk contoh membatalkan pilihan streaming, lihat Tutorial: Mendekode Audio.

Jika aliran tidak dipilih, metode IMFSourceReader::ReadSample mengembalikan MF_E_INVALIDREQUEST untuk aliran tersebut. Metode IMFSourceReader lainnya valid untuk aliran yang tidak dipilih.

Pemilihan aliran tidak memengaruhi cara pembaca sumber memuat atau membongkar decoder dalam memori. Secara khusus, membatalkan pilihan aliran tidak memaksa pembaca sumber untuk membongkar dekoder untuk aliran tersebut.

Antarmuka ini tersedia di Windows Vista jika Suplemen Pembaruan Platform untuk Windows Vista diinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista, dan Platform Update Supplement untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	mfreadwrite.h

Lihat juga

IMFSourceReader

Pembaca Sumber