Metode ICaptureGraphBuilder2::GetFiltergraph (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 GetFiltergraph mengambil grafik filter yang digunakan penyusun grafik tangkapan.

Sintaks

HRESULT GetFiltergraph(
  [out] IGraphBuilder **ppfg
);

Parameter

[out] ppfg

Menerima penunjuk antarmuka IGraphBuilder .

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Argumen penunjuk NULL.
E_UNEXPECTED	Tidak ada grafik filter.

Keterangan

Awalnya, penyusun grafik pengambilan tidak menahan penunjuk ke grafik filter. Metode ini mengembalikan E_UNEXPECTED sampai salah satu metode berikut telah dipanggil:

• ICaptureGraphBuilder2::RenderStream
• ICaptureGraphBuilder2::SetFiltergraph
• ICaptureGraphBuilder2::SetOutputFileName

Metode ini menaikkan jumlah referensi pada antarmuka IGraphBuilder . Pastikan untuk merilis antarmuka ketika Anda selesai dengannya.

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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka ICaptureGraphBuilder2