共用方式為

MFCreateAggregateSource 函式 (mfidl.h)

  • 發行項

建立可匯總媒體來源集合的媒體來源。

語法

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

參數

[in] pSourceCollection

集合物件之 IMFCollection 介面的指標，其中包含媒體來源的清單。

[out] ppAggSource

接收匯總媒體來源之 IMFMediaSource 介面的指標。 呼叫端必須釋放 介面。

傳回值

函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 pSourceCollection 集合不包含任何專案。

備註

匯總的媒體來源適用於合併來自不同媒體來源的數據流。 例如，您可以使用它來結合視訊擷取來源和音訊擷取來源。

範例

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;    
}

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mf.lib
Dll Mf.dll

另請參閱

IMFMediaSource

媒體基礎函式