Převody typů médií

Někdy je nutné převést mezi typy médií Media Foundation a staršími strukturami typů médií z DirectShow nebo sady Windows Media Format SDK.

Z struktury formátu na typ základu média

Následující funkce inicializují typ média Media Foundation ze struktury formátu. Tyto funkce jsou užitečné také v případě, že datový proud nebo hlavička souboru obsahují strukturu formátu. Například hlavička souboru pro zvukové soubory WAVE obsahuje strukturu WAVEFORMATEX.

Z typu Media Foundation do struktury formátu

Následující funkce vytvářejí nebo inicializují strukturu formátu z typu média Media Foundation.

Mapování formátu

Následující tabulky uvádějí atributy Media Foundation, které odpovídají různým strukturám formátu. Ne všechny tyto atributy lze přeložit přímo. K provádění převodů byste měli použít funkce uvedené v předchozí části; tyto tabulky jsou k dispozici především pro referenci.

AM_MEDIA_TYPE

WAVEFORMATEX, WAVEFORMATEXTENSIBLE

VIDEOINFOHEADER, VIDEOINFOHEADER2

Následující atributy lze odvodit ze struktury VIDEOINFOHEADER nebo VIDEOINFOHEADER2, ale také vyžadují určité znalosti podrobností o formátu. Různé formáty YUV mají například různé požadavky na krok.

• MF_MT_DEFAULT_STRIDE
• MF_MT_MINIMUM_DISPLAY_APERTURE
• MF_MT_PAN_SCAN_APERTURE

MPEG1VIDEOINFO

MPEG2VIDEOINFO

Příklady

Následující kód vyplní BITMAPINFOHEADER strukturu z typu média videa. Všimněte si, že tyto převody ztratí některé informace o formátu (prokládání, frekvence snímků, rozšířená barevná data). Může však být užitečné při ukládání rastrového obrázku z rámečku videa, například.

#include <dshow.h>
#include <dvdmedia.h>

// Converts a video type to a BITMAPINFO structure.
// The caller must free the structure by calling CoTaskMemFree.

// Note that this conversion loses some format information, including 
// interlacing, and frame rate.

HRESULT GetBitmapInfoHeaderFromMFMediaType(
    IMFMediaType *pType,            // Pointer to the media type.
    BITMAPINFOHEADER **ppBmih,      // Receives a pointer to the structure. 
    DWORD *pcbSize)                 // Receives the size of the structure.
{
    *ppBmih = NULL;
    *pcbSize = 0;

    GUID majorType = GUID_NULL;
    AM_MEDIA_TYPE *pmt = NULL;
    DWORD cbSize = 0;
    DWORD cbOffset = 0;
    BITMAPINFOHEADER *pBMIH = NULL;

    // Verify that this is a video type.
    HRESULT hr = pType->GetMajorType(&majorType);
    if (FAILED(hr))
    {
        goto done;
    }

    if (majorType != MFMediaType_Video)
    {
        hr = MF_E_INVALIDMEDIATYPE;
        goto done;
    }

    hr = pType->GetRepresentation(AM_MEDIA_TYPE_REPRESENTATION, (void**)&pmt);
    if (FAILED(hr))
    {
        goto done;
    }

    if (pmt->formattype == FORMAT_VideoInfo)
    {
        cbOffset = (FIELD_OFFSET(VIDEOINFOHEADER,bmiHeader));
    }
    else if (pmt->formattype == FORMAT_VideoInfo2)
    {
        cbOffset = (FIELD_OFFSET(VIDEOINFOHEADER2,bmiHeader));
    }
    else
    {
        hr = MF_E_INVALIDMEDIATYPE; // Unsupported format type.
        goto done;
    }

    if (pmt->cbFormat - cbOffset < sizeof(BITMAPINFOHEADER))
    {
        hr = E_UNEXPECTED; // Bad format size. 
        goto done;
    }

    cbSize = pmt->cbFormat - cbOffset;

    pBMIH = (BITMAPINFOHEADER*)CoTaskMemAlloc(cbSize);
    if (pBMIH == NULL)
    {
        hr = E_OUTOFMEMORY;
        goto done;
    }
    
    CopyMemory(pBMIH, pmt->pbFormat + cbOffset, cbSize);
    
    *ppBmih = pBMIH;
    *pcbSize = cbSize;

done:
    if (pmt)
    {
        pType->FreeRepresentation(AM_MEDIA_TYPE_REPRESENTATION, pmt);
    }
    return hr;
}

Související témata

typy médií