Fonction MFInitVideoFormat (mfapi.h)

Article
08/24/2023

[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

Note Avant Windows 7, cette fonction était exportée à partir de evr.dll. À partir de Windows 7, cette fonction est exportée à partir de mfplat.dll et evr.dll exporte une fonction stub qui appelle mfplat.dll. Pour plus d’informations, consultez Modifications de bibliothèque dans Windows 7.

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


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfapi.h
Bibliothèque	Evr.lib
DLL	Mfplat.dll

Voir aussi

Fonctions Media Foundation

Types de média

Types de médias vidéo

Share via