MFInitVideoFormat-Funktion (mfapi.h)

[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

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

Weitere Informationen

Media Foundation-Funktionen

Medientypen

Videomedientypen