CBaseControlVideo.SetTargetRect-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetTargetRect -Methode legt das aktuelle Zielrechteck (rein virtuell) fest. Dies ist eine interne Memberfunktion, die aufgerufen wird, wenn sich das Zielrechteck ändert.

Syntax

virtual HRESULT SetTargetRect(
   RECT *pTargetRect
) = 0;

Parameter

pTargetRect

Zeiger auf das Zielrechteck.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Abgeleitete Klassen sollten dies überschreiben, um zu wissen, wann sich das Zielrechteck ändert. Sie wird von den folgenden Memberfunktionen aufgerufen.

• CBaseControlVideo::SetDestinationPosition
• CBaseControlVideo::p ut_DestinationLeft
• CBaseControlVideo::p ut_DestinationWidth
• CBaseControlVideo::p ut_DestinationTop
• CBaseControlVideo::p ut_DestinationHeight

Im folgenden Beispiel wird eine Implementierung dieser Funktion in einer abgeleiteten Klasse veranschaulicht.

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

In diesem Beispiel ist CVideoText eine von CBaseControlVideo abgeleitete Klasse, m_pRenderer ein Objekt einer klasse enthält, die von CBaseVideoRenderer abgeleitet ist, und der m_DrawImage Datenmember, der in der abgeleiteten Klasse definiert ist, enthält ein CDrawImage-Objekt .

Anforderungen

Anforderung	Wert
Header	Ctlutil.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseControlVideo-Klasse