Metode IGraphConfig::P ushThroughData (strmif.h)

Artikel
07/28/2023

[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
E_OUTOFMEMORY	Gagal mengalokasikan memori yang diperlukan.
VFW_E_NOT_FOUND	Tidak dapat menemukan pin input kandidat.
VFW_E_STATE_CHANGED	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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IGraphConfig

Bagikan melalui