Metode CBaseControlVideo.SetSourceRect

[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 SetSourceRect ini mengatur persegi panjang video sumber saat ini (virtual murni). Ini adalah fungsi anggota internal yang dipanggil ketika persegi panjang sumber berubah.

Sintaks

virtual HRESULT SetSourceRect(
   RECT *pSourceRect
) = 0;

Parameter

pSourceRect

Penunjuk ke persegi sumber.

Nilai kembali

Mengembalikan nilai HRESULT .

Keterangan

Kelas turunan harus mengambil alih fungsi anggota ini untuk mengetahui kapan persegi panjang sumber berubah. Ini dipanggil dari fungsi anggota berikut.

• CBaseControlVideo::SetSourcePosition
• CBaseControlVideo::p ut_SourceLeft
• CBaseControlVideo::p ut_SourceWidth
• CBaseControlVideo::p ut_SourceTop
• CBaseControlVideo::p ut_SourceHeight

Contoh berikut menunjukkan implementasi fungsi ini di kelas turunan.

HRESULT CVideoText::SetSourceRect(RECT *pSourceRect)
{
    m_pRenderer->m_DrawImage.SetSourceRect(pSourceRect);
    return NOERROR;
}

Dalam contoh ini, CVideoText adalah kelas yang berasal dari CBaseControlVideo, m_pRenderer menyimpan objek kelas yang berasal dari CBaseVideoRenderer, dan anggota data m_DrawImage, yang ditentukan dalam kelas turunan, menyimpan objek CDrawImage .

Persyaratan

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

Lihat juga

Kelas CBaseControlVideo