IMFASFProfile::Metode GetStream (wmcontainer.h)

Artikel
03/13/2024

Mengambil aliran dari profil berdasarkan indeks aliran, dan/atau mengambil nomor aliran untuk indeks aliran.

Sintaks

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parameter

[in] dwStreamIndex

Indeks aliran yang akan diambil. Stream indeks berurutan dan berbasis nol. Anda bisa mendapatkan jumlah aliran yang ada di profil dengan memanggil metode IMFASFProfile::GetStreamCount .

[out] pwStreamNumber

Menerima nomor aliran dari aliran yang diminta. Stream angka berbasis satu dan belum tentu berurutan. Parameter ini dapat diatur ke NULL jika nomor aliran tidak diperlukan.

[out] ppIStream

Menerima penunjuk ke antarmuka IMFASFStreamConfig dari objek konfigurasi aliran ASF. Pemanggil harus merilis antarmuka. Parameter ini dapat berupa NULL jika Anda ingin mengambil nomor aliran tanpa mengakses konfigurasi aliran.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Metode ini tidak membuat salinan objek konfigurasi aliran. Pointer yang diambil menunjuk ke objek dalam objek profil. Anda tidak boleh membuat perubahan apa pun pada objek konfigurasi aliran menggunakan pointer ini, karena melakukannya dapat memengaruhi objek profil dengan cara yang tidak terduga.

Untuk mengubah konfigurasi objek konfigurasi aliran di profil, Anda harus terlebih dahulu mengkloning objek konfigurasi aliran dengan memanggil IMFASFStreamConfig::Clone. Buat perubahan apa pun yang diperlukan pada klon objek lalu tambahkan objek yang diperbarui dengan memanggil metode IMFASFProfile::SetStream .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wmcontainer.h
Pustaka	Mfuuid.lib