Metode CTransformFilter.Transform

[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 mengubah Transform sampel input untuk menghasilkan sampel output.

Sintaks

virtual HRESULT Transform(
   IMediaSample *pIn,
   IMediaSample *pOut
);

Parameter

Pin

Arahkan ke antarmuka IMediaSample sampel input.

Cemberut

Arahkan ke antarmuka IMediaSample sampel output.

Nilai kembali

Kelas dasar mengembalikan E_UNEXPECTED.

Kelas turunan harus mengembalikan nilai HRESULT , yang menunjukkan keberhasilan atau kegagalan. Nilai yang mungkin termasuk yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode	Deskripsi
S_FALSE	Jangan mengirimkan sampel ini.
S_OK	Berhasil.

Keterangan

Ambil alih metode ini untuk menghasilkan data output. Baca data input dari sampel yang ditentukan oleh parameter pIn , dan tulis data baru ke dalam sampel yang ditentukan oleh parameter pOut .

Sebelum filter memanggil metode ini, filter menyalin properti dari sampel input ke sampel output. Metode Transform harus mengatur properti apa pun yang berbeda antara dua sampel, menggunakan metode IMediaSample atau antarmuka IMediaSample2 (jika tersedia).

Jika filter tidak boleh mengirimkan sampel ini (misalnya, untuk mendukung kontrol kualitas), metode harus mengembalikan S_FALSE.

Persyaratan

Persyaratan	Nilai
Header	Transfrm.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Kelas CTransformFilter