Función MFCreateAggregateSource (mfidl.h)

Crea un origen multimedia que agrega una colección de orígenes multimedia.

Sintaxis

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

Parámetros

[in] pSourceCollection

Puntero a la interfaz IMFCollection del objeto de colección que contiene una lista de orígenes multimedia.

[out] ppAggSource

Recibe un puntero a la interfaz IMFMediaSource del origen multimedia agregado. El autor de la llamada debe liberar la interfaz .

Valor devuelto

La función devuelve un HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	La colección pSourceCollection no contiene ningún elemento.

Comentarios

El origen multimedia agregado es útil para combinar secuencias de orígenes multimedia independientes. Por ejemplo, puede usarlo para combinar un origen de captura de vídeo y un origen de captura de audio.

Ejemplos

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfidl.h
Library	Mf.lib
Archivo DLL	Mf.dll

Consulte también

IMFMediaSource

Funciones de Media Foundation