Bagikan melalui

IGraphBuilder::Metode render (strmif.h)

  • Artikel

[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 Render membangun grafik filter yang merender data dari pin output tertentu.

Sintaks

HRESULT Render(
  [in] IPin *ppinOut
);

Parameter

[in] ppinOut

Arahkan ke antarmuka IPin pada pin output.

Mengembalikan nilai

Mengembalikan HRESULT. Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
VFW_S_AUDIO_NOT_RENDERED
 Keberhasilan parsial; audio tidak dirender.
VFW_S_DUPLICATE_NAME
 Sukses; Filter Graph Manager mengubah nama filter untuk menghindari duplikasi.
VFW_S_PARTIAL_RENDER
 Keberhasilan parsial; beberapa aliran dalam film ini dalam format yang tidak didukung.
VFW_S_VIDEO_NOT_RENDERED
 Keberhasilan parsial; video tidak dirender.
E_ABORT
 Operasi dibatalkan.
E_OUTOFMEMORY
 Memori tidak cukup.
E_POINTER
 Argumen pointer NULL.
VFW_E_CANNOT_CONNECT
 Tidak ada kombinasi filter perantara yang dapat ditemukan untuk membuat koneksi.
VFW_E_CANNOT_RENDER
 Tidak ada kombinasi filter yang dapat ditemukan untuk merender aliran.
VFW_E_NO_ACCEPTABLE_TYPES
 Tidak ada jenis media umum di antara pin ini.
VFW_E_NOT_IN_GRAPH
 Filter tempat pin ini berada tidak berada dalam grafik filter.

Keterangan

Metode ini merender data dari pin output tertentu, menambahkan filter baru ke grafik sesuai kebutuhan. Filter dicoba dalam urutan yang sama seperti untuk metode IGraphBuilder::Connect . Untuk informasi selengkapnya, lihat Intelligent Connect.

Selama proses koneksi, Filter Graph Manager mengabaikan pin pada filter perantara jika nama pin dimulai dengan tilde (~). Untuk informasi selengkapnya, lihat PIN_INFO.

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 IGraphBuilder