Metode IMFSourceReader::SetStreamSelection (mfreadwrite.h)

Artikel
03/13/2024

Memilih atau membatalkan pilihan satu atau beberapa aliran.

Sintaks

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

Parameter

[in] dwStreamIndex

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

Nilai	Makna
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 akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ada dua kegunaan 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 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.

Stream pilihan tidak memengaruhi bagaimana pembaca sumber memuat atau membongkar dekode dalam memori. Secara khusus, membatalkan pilihan aliran tidak memaksa pembaca sumber untuk membongkar dekoder untuk aliran tersebut.

Antarmuka ini tersedia pada Windows Vista jika Pelengkap Pembaruan Platform untuk Windows Vista diinstal.

Persyaratan

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

Lihat juga

IMFSourceReader

Pembaca Sumber

Share via