CBaseControlVideo.IsDefaultSourceRect-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 IsDefaultSourceRect -Methode bestimmt, ob der Renderer das Standardquellrechteck (rein virtuell) verwendet.

Syntax

virtual HRESULT IsDefaultSourceRect() = 0;

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK zurück, wenn der Renderer die Standardquelle verwendet. gibt andernfalls S_FALSE zurück.

Bemerkungen

Diese Memberfunktion muss in der abgeleiteten Klasse implementiert werden. Sie wird von der CBaseControlVideo::IsUsingDefaultSource-Memberfunktion aufgerufen.

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

// Return S_OK if using the default source; otherwise, S_FALSE.
HRESULT CVideoText::IsDefaultSourceRect()
{
    RECT SourceRect;

    VIDEOINFO *pVideoInfo = (VIDEOINFO *) m_pRenderer->m_mtIn.Format();
    BITMAPINFOHEADER *pHeader = HEADER(pVideoInfo);
    m_pRenderer->m_DrawImage.GetSourceRect(&SourceRect);

    // Check the coordinates that match the video dimensions.

    if (SourceRect.left != 0 || SourceRect.top != 0 ||
            SourceRect.right != pHeader->biWidth ||
                SourceRect.bottom != pHeader->biHeight) {
                    return S_FALSE;
    }
    return S_OK;
}

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 . Das m_mtIn Datenmember, das ebenfalls in der abgeleiteten Klasse definiert ist, enthält ein CMediaType-Objekt mit dem Medientyp des Eingabenadels.

Anforderungen

Siehe auch

CBaseControlVideo-Klasse