Fonction MFInitVideoFormat (mfapi.h)

[Cette API n’est pas prise en charge et peut être modifiée ou indisponible à l’avenir. Les applications doivent éviter d’utiliser la structure MFVIDEOFORMAT et utiliser des attributs de type de média à la place. Pour plus d’informations, consultez Types de médias vidéo.]

Initialise une structure MFVIDEOFORMAT pour un format vidéo standard tel que dvd, télévision analogique ou télévision numérique ATSC.

Syntaxe

HRESULT MFInitVideoFormat(
  [out] MFVIDEOFORMAT         *pVideoFormat,
  [in]  MFStandardVideoFormat type
);

Paramètres

[out] pVideoFormat

Pointeur vers une structure MFVIDEOFORMAT . La fonction remplit les membres de la structure en fonction du format vidéo spécifié dans le paramètre type.

[in] type

Format vidéo, spécifié en tant que membre de l’énumération MFStandardVideoFormat .

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Exemples

L’exemple suivant crée un objet de type média pour un format vidéo standard.

// Creates a media type for a standard video format.
HRESULT CreateStandardVideoMediaType(MFStandardVideoFormat type, IMFMediaType **ppMediaType)
{
    IMFMediaType *pMediaType = NULL;

    MFVIDEOFORMAT format;

    // Fill in the MFVIDEOFORMAT structure for the video format.
    HRESULT hr = MFInitVideoFormat(&format, type);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create a new (empty) media type.
    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    // Initialize the media type from the MFVIDEOFORMAT structure.
    hr = MFInitMediaTypeFromMFVideoFormat(pMediaType, &format, sizeof(format));
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppMediaType = pMediaType;
    (*ppMediaType)->AddRef();

done:
    SafeRelease(&pMediaType);
    return hr;
}

Spécifications

Voir aussi

Fonctions Media Foundation

Types de média

Types de médias vidéo