METODE IMFPMediaItem::SetStreamSink (mfplay.h)

Penting Usang. API ini dapat dihapus dari rilis Windows di masa mendatang. Aplikasi harus menggunakan Sesi Media untuk pemutaran.

 

Menyetel sink media untuk item media. Sink media adalah objek yang menggunakan data dari satu atau beberapa aliran.

Sintaks

HRESULT SetStreamSink(
  [in] DWORD    dwStreamIndex,
  [in] IUnknown *pMediaSink
);

Parameter

[in] dwStreamIndex

Indeks aliran berbasis nol pada sumber media. Sink media akan menerima data dari aliran ini.

[in] pMediaSink

Pointer IUnknown yang menentukan sink media. Berikan salah satu hal berikut ini:

• Penunjuk ke sink aliran. Setiap sink media berisi satu atau beberapa sink aliran. Setiap stream sink menerima data dari satu aliran. Sink aliran harus mengekspos antarmuka IMFStreamSink .
• Penunjuk ke objek aktivasi yang membuat sink media. Objek aktivasi harus mengekspos antarmuka IMFActivate . Item media menggunakan sink aliran pertama pada sink media (yaitu, streaming sink pada indeks 0).
• NULL. Jika Anda mengatur pMediaSink ke NULL, sink media default untuk jenis aliran akan digunakan.

Nilai kembali

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

Keterangan

Secara default, objek pemutar MFPlay merender aliran audio ke Streaming Audio Renderer (SAR) dan aliran video ke Enhanced Video Renderer (EVR). Anda dapat menggunakan metode SetStreamSink untuk menyediakan sink media yang berbeda untuk aliran audio atau video; atau untuk mendukung jenis streaming lainnya selain audio dan video. Anda juga dapat menggunakannya untuk mengonfigurasi SAR atau EVR sebelum digunakan.

Panggil metode ini sebelum memanggil IMFPMediaPlayer::SetMediaItem. Memanggil metode ini setelah SetMediaItem tidak berpengaruh, kecuali Anda menghentikan pemutaran dan memanggil SetMediaItem lagi.

Untuk mengatur ulang item media untuk menggunakan sink media default, atur pMediaSink ke NULL.

Pengoptimalan Pemutaran Jarak Jauh

Jika aplikasi berjalan melalui Desktop Jauh, dan Anda memanggil metode ini dengan nilai non-NULL untuk aliran audio atau video, MFPlay menonaktifkan pengoptimalan pemutaran jarak jauh. Keterangan ini hanya berlaku untuk aliran audio dan video. Ini tidak berlaku untuk aliran yang berisi beberapa jenis data lainnya, seperti teks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfplay.h

Lihat juga

IMFPMediaItem

Sink Media

Menggunakan MFPlay untuk Pemutaran Audio/Video