CBaseControlVideo.GetTargetRect-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetTargetRect -Methode ruft das Zielrechteck ab. Dies ist eine interne Hilfsfunktion.

Syntax

virtual HRESULT GetTargetRect(
   RECT *pTargetRect
) = 0;

Parameter

pTargetRect

Zeiger auf das Zielrechteck.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Diese Memberfunktion muss in der abgeleiteten Klasse überschrieben werden, um das Zielrechteck zurückzugeben, das vom Videorenderer gespeichert wird. Sie wird von den folgenden CBaseControlVideo-Memberfunktionen aufgerufen.

• 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

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

// Return the current destination rectangle.
HRESULT CVideoText::GetTargetRect(RECT *pTargetRect)
{
    ASSERT(pTargetRect);
    m_pRenderer->m_DrawImage.GetTargetRect(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 in der abgeleiteten Klasse definierte m_DrawImage Datenmember enthält ein CDrawImage-Objekt .

Anforderungen

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

Siehe auch

CBaseControlVideo-Klasse