Metode IQualityControl::SetSink (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Metode ini SetSink mengatur objek IQualityControl yang akan menerima pesan kualitas.
Sintaks
HRESULT SetSink(
IQualityControl *piqc
);
Parameter
piqc
Arahkan ke objek IQualityControl tempat pemberitahuan harus dikirim.
Mengembalikan nilai
Mengembalikan nilai HRESULT yang bergantung pada implementasinya. HRESULT dapat menjadi salah satu konstanta standar berikut, atau nilai lain yang tidak tercantum.
| Menampilkan kode | Deskripsi |
|---|---|
|
Kegagalan. |
|
Argumen pointer NULL. |
|
Argumen tidak valid. |
|
Metode tidak didukung. |
|
Berhasil. |
Keterangan
Filter yang menerima panggilan ke metode ini harus merekam piqc tetapi tidak boleh menambahkan jumlah referensi ke dalamnya. Objek yang ditujukkan akan menjadi manajer kualitas dan akan menjadi bagian dari grafik filter (misalnya, distributor plug-in). Menambahkan jumlah referensi ke ini dapat menyebabkan masalah referensi melingkar.
Referensi ke objek yang ditentukan dalam piqc dijamin valid sampai metode ini dipanggil dengan nilai null.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |