Metode IGraphConfig::P ushThroughData (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 PushThroughData mendorong data melalui grafik filter ke pin yang ditentukan.
Sintaks
HRESULT PushThroughData(
[in] IPin *pOutputPin,
[in] IPinConnection *pConnection,
[in] HANDLE hEventAbort
);
Parameter
[in] pOutputPin
Penunjuk ke antarmuka IPin dari pin output di grafik filter.
[in] pConnection
Penunjuk ke antarmuka IPinConnection dari pin input di grafik filter. Parameter ini bisa NULL.
[in] hEventAbort
Menangani ke peristiwa. Jika penelepon adalah panggilan filter pada salah satu utas pemrosesan datanya, parameter ini harus menjadi handel ke peristiwa yang akan diberi sinyal ketika filter dimasukkan ke dalam status berhenti. Jika tidak, parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Keterangan.
Mengembalikan nilai
Mengembalikan S_OK jika berhasil. Jika tidak, mengembalikan kode kesalahan yang mungkin merupakan salah satu nilai berikut, atau yang lain tidak tercantum.
| Menampilkan kode | Deskripsi |
|---|---|
|
Gagal mengalokasikan memori yang diperlukan. |
|
Tidak dapat menemukan pin input kandidat. |
|
Status filter berubah selama operasi. |
Keterangan
Metode ini mendorong melalui data yang tertunda, dari pin output tertentu ke pin input tertentu. Secara opsional, Anda dapat membiarkan pin input tidak ditentukan dan membiarkan metode mencari grafik filter untuk kandidat terbaik. Jangan panggil metode ini dari utas yang mendorong data.
Jika filter memanggil metode ini pada salah satu utas pemrosesan datanya sendiri, filter akan menciptakan potensi kebuntuan. Metode ini mendapatkan kunci pada grafik filter, yang dapat memblokir filter agar tidak berhenti menerima panggilan ke IMediaFilter::Stop. Untuk mencegah situasi ini, metode ini mengambil handel ke objek peristiwa yang disediakan oleh filter. Filter harus memberi sinyal peristiwa jika menerima panggilan ke metode Stop-nya .
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |