Share via

IMFMediaSink::RemoveStreamSink method (mfidl.h)

  • Artikel

Menghapus sink aliran dari sink media.

Sintaks

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Parameter

[in] dwStreamSinkIdentifier

Pengidentifikasi aliran yang akan dihapus. Pengidentifikasi aliran ditentukan saat Anda memanggil IMFMediaSink::AddStreamSink untuk menambahkan sink aliran.

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_INVALIDARG
 Sink aliran khusus ini tidak dapat dihapus.
MF_E_INVALIDSTREAMNUMBER
 Nomor aliran tidak valid.
MF_E_NOT_INITIALIZED
 Sink media belum diinisialisasi.
MF_E_SHUTDOWN
 Metode Matikan sink media telah dipanggil.
MF_E_STREAMSINKS_FIXED
 Sink media ini memiliki set sink aliran tetap. Stream sink tidak dapat dihapus.

Keterangan

Setelah metode ini dipanggil, objek stream sink yang sesuai tidak lagi valid. Metode IMFMediaSink::GetStreamSinkByIndex dan IMFMediaSink::GetStreamSinkById tidak akan lagi mengembalikan sink streaming tersebut. Anda dapat menggunakan kembali pengidentifikasi aliran jika Anda menambahkan aliran lain (dengan memanggil AddStreamSink).

Tidak semua sink media mendukung metode ini. Jika sink media tidak mendukung metode ini, metode IMFMediaSink::GetCharacteristics mengembalikan bendera MEDIASINK_FIXED_STREAMS.

Dalam beberapa kasus, sink media mendukung metode ini tetapi tidak memungkinkan setiap sink streaming dihapus. (Misalnya, mungkin tidak mengizinkan streaming 0 dihapus.)

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfidl.h
Pustaka Mfuuid.lib

Lihat juga

IMFMediaSink

Sink Media