Metode CBaseControlVideo.GetTargetRect

[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 mengambil GetTargetRect persegi panjang tujuan. Ini adalah fungsi anggota pembantu internal.

Sintaks

virtual HRESULT GetTargetRect(
   RECT *pTargetRect
) = 0;

Parameter

pTargetRect

Penunjuk ke persegi panjang tujuan.

Nilai kembali

Mengembalikan nilai HRESULT .

Keterangan

Fungsi anggota ini harus ditimpa di kelas turunan untuk mengembalikan persegi panjang target yang dipegang oleh perender video. Ini dipanggil dari fungsi anggota CBaseControlVideo berikut.

• CBaseControlVideo::GetDestinationPosition
• CBaseControlVideo::p ut_DestinationLeft
• CBaseControlVideo::get_DestinationLeft
• CBaseControlVideo::p ut_DestinationWidth
• CBaseControlVideo::get_DestinationWidth
• CBaseControlVideo::p ut_DestinationTop
• CBaseControlVideo::get_DestinationTop
• CBaseControlVideo::p ut_DestinationHeight
• CBaseControlVideo::get_DestinationHeight

Contoh berikut menunjukkan implementasi fungsi ini di kelas turunan.

// Return the current destination rectangle.
HRESULT CVideoText::GetTargetRect(RECT *pTargetRect)
{
    ASSERT(pTargetRect);
    m_pRenderer->m_DrawImage.GetTargetRect(pTargetRect);
    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