MFInitVideoFormat-Funktion (mfapi.h)

Artikel
08/24/2023

[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein. Anwendungen sollten die Verwendung der MFVIDEOFORMAT-Struktur vermeiden und stattdessen Medientypattribute verwenden. Weitere Informationen finden Sie unter Videomedientypen.]

Initialisiert eine MFVIDEOFORMAT-Struktur für ein Standardvideoformat wie DVD, analoges Fernsehen oder ATSC-Digitalfernsehen.

Syntax

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

Parameter

[out] pVideoFormat

Ein Zeiger auf eine MFVIDEOFORMAT-Struktur . Die Funktion füllt die Strukturmember basierend auf dem videoformat aus, das im type-Parameter angegeben ist.

[in] type

Das Videoformat, das als Member der MFStandardVideoFormat-Enumeration angegeben wird.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Vor Windows 7 wurde diese Funktion aus evr.dll exportiert. Ab Windows 7 wird diese Funktion aus mfplat.dll exportiert, und evr.dll exportiert eine Stubfunktion, die in mfplat.dll aufruft. Weitere Informationen finden Sie unter Bibliotheksänderungen in Windows 7.

Beispiele

Im folgenden Beispiel wird ein Medientypobjekt für ein Standardvideoformat erstellt.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfapi.h
Bibliothek	Evr.lib
DLL	Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen

Medientypen

Videomedientypen

Freigeben über