Conversions de types de supports

Il est parfois nécessaire de convertir entre les types multimédias Media Foundation et les anciennes structures de type multimédia à partir de DirectShow ou du Kit de développement logiciel (SDK) Windows Media Format.

D’une structure de format à un type Media Foundation

Les fonctions suivantes initialisent un type de média Media Foundation à partir d’une structure de format. Ces fonctions sont également utiles si un flux de données ou un en-tête de fichier contient une structure de format. Par exemple, l’en-tête de fichier pour les fichiers audio WAVE contient une structureWAVEFORMATEX.

D’un type Media Foundation à une structure de format

Les fonctions suivantes créent ou initialisent une structure de format à partir d’un type de média Media Foundation.

Mappages de format

Les tableaux suivants répertorient les attributs Media Foundation qui correspondent à différentes structures de format. Tous ces attributs ne peuvent pas être traduits directement. Pour effectuer des conversions, vous devez utiliser les fonctions répertoriées dans la section précédente ; ces tables sont fournies principalement pour référence.

AM_MEDIA_TYPE

WAVEFORMATEX, WAVEFORMATEXTENSIBLE

VIDEOINFOHEADER, VIDEOINFOHEADER2

Les attributs suivants peuvent être déduits de la structure VIDEOINFOHEADER ou VIDEOINFOHEADER2, mais nécessitent également une connaissance des détails du format. Par exemple, différents formats YUV ont des exigences de pas à pas différentes.

• MF_MT_DEFAULT_STRIDE
• MF_MT_MINIMUM_DISPLAY_APERTURE
• MF_MT_PAN_SCAN_APERTURE

MPEG1VIDEOINFO

MPEG2VIDEOINFO

Exemples

Le code suivant remplit une structure BITMAPINFOHEADER à partir d’un type de média vidéo. Notez que ces conversions perdent certaines informations de format (entrelacement, fréquence d’images, données de couleur étendues). Toutefois, il peut être utile d’enregistrer une bitmap à partir d’une image vidéo, par exemple.

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

Rubriques connexes

types de supports