Conversioni dei tipi di supporto

Occasionalmente è necessario convertire tra tipi di supporti di Media Foundation e le strutture del tipo di supporto meno recenti da DirectShow o Windows Media Format SDK.

Da una struttura di formato a un tipo di base multimediale

Le funzioni seguenti inizializzano un tipo di supporto di Media Foundation da una struttura di formato. Queste funzioni sono utili anche se un flusso di dati o un'intestazione di file contiene una struttura di formato. Ad esempio, l'intestazione di file per i file audio WAVE contiene una struttura WAVEFORMATEX .

Da un tipo di media foundation a una struttura di formato

Le funzioni seguenti creano o inizializzano una struttura di formato da un tipo di supporto di Media Foundation.

Mapping di formato

Le tabelle seguenti elencano gli attributi di Media Foundation corrispondenti a varie strutture di formato. Non tutti questi attributi possono essere convertiti direttamente. Per eseguire conversioni, è necessario usare le funzioni elencate nella sezione precedente; queste tabelle vengono fornite principalmente per riferimento.

AM_MEDIA_TYPE

WAVEFORMATEX, WAVEFORMATEXEXTENSIBLE

VIDEOINFOHEADER, VIDEOINFOHEADER2

Gli attributi seguenti possono essere dedotti dalla struttura VIDEOINFOHEADER o VIDEOINFOHEADER2 , ma richiedono anche alcune informazioni sui dettagli del formato. Ad esempio, diversi formati YUV hanno requisiti stride diversi.

• MF_MT_DEFAULT_STRIDE
• MF_MT_MINIMUM_DISPLAY_APERTURE
• MF_MT_PAN_SCAN_APERTURE

MPEG1VIDEOINFO

MPEG2VIDEOINFO

Esempio

Il codice seguente compila una struttura BITMAPINFOHEADER da un tipo di supporto video. Si noti che queste conversioni perdono alcune delle informazioni sul formato (interlacciamento, frequenza dei fotogrammi, dati di colore estesi). Tuttavia, potrebbe essere utile quando si salva una bitmap da un fotogramma video, ad esempio.

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

Argomenti correlati

Tipi di supporti