MFCreateAggregateSource-Funktion (mfidl.h)

Erstellt eine Medienquelle, die eine Sammlung von Medienquellen aggregiert.

Syntax

HRESULT MFCreateAggregateSource(
  [in]  IMFCollection  *pSourceCollection,
  [out] IMFMediaSource **ppAggSource
);

Parameter

[in] pSourceCollection

Ein Zeiger auf die IMFCollection-Schnittstelle des Auflistungsobjekts, das eine Liste von Medienquellen enthält.

[out] ppAggSource

Empfängt einen Zeiger auf die IMFMediaSource-Schnittstelle der aggregierten Medienquelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Hinweise

Die aggregierte Medienquelle ist nützlich, um Datenströme aus separaten Medienquellen zu kombinieren. Sie können sie beispielsweise verwenden, um eine Videoaufnahmequelle und eine Audioaufnahmequelle zu kombinieren.

Beispiele

HRESULT CreateAggregatedSource(
    IMFMediaSource *pSource1,
    IMFMediaSource *pSource2,
    IMFMediaSource **ppAggSource
    )
{
    *ppAggSource = NULL;

    IMFCollection *pCollection = NULL;

    HRESULT hr = MFCreateCollection(&pCollection);

    if (SUCCEEDED(hr))
    {
        hr = pCollection->AddElement(pSource1);
    }
    if (SUCCEEDED(hr))
    {
        hr = pCollection->AddElement(pSource2);
    }
    if (SUCCEEDED(hr))
    {
        hr = MFCreateAggregateSource(pCollection, ppAggSource);
    }
    SafeRelease(&pCollection);
    return hr;    
}

Anforderungen

Weitere Informationen

IMFMediaSource

Media Foundation-Funktionen