CBaseControlVideo.GetSourceRect-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 GetSourceRect
-Methode ruft das Quellrechteck ab. Dies ist eine interne Methode.
Syntax
virtual HRESULT GetSourceRect(
RECT *pSourceRect
) = 0;
Parameter
-
pSourceRect
-
Zeiger auf das abgerufene Quellrechteck.
Rückgabewert
Gibt einen HRESULT-Wert zurück.
Bemerkungen
Diese Memberfunktion muss in der abgeleiteten Klasse überschrieben werden, um das Vom Videorenderer gespeicherte Quellrechteck zurückzugeben. Sie wird von den folgenden CBaseControlVideo-Memberfunktionen aufgerufen.
- CBaseControlVideo::GetSourcePosition
- CBaseControlVideo::p ut_SourceLeft
- CBaseControlVideo::get_SourceLeft
- CBaseControlVideo::p ut_SourceWidth
- CBaseControlVideo::get_SourceWidth
- CBaseControlVideo::p ut_SourceTop
- CBaseControlVideo::get_SourceTop
- CBaseControlVideo::p ut_SourceHeight
- CBaseControlVideo::get_SourceHeight
Im folgenden Beispiel wird eine Implementierung dieser Funktion in einer abgeleiteten Klasse veranschaulicht.
// Return the current source rectangle
HRESULT CVideoText::GetSourceRect(RECT *pSourceRect)
{
ASSERT(pSourceRect);
m_pRenderer->m_DrawImage.GetSourceRect(pSourceRect);
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 |
|
Bibliothek |
|