Funzione MFInitVideoFormat (mfapi.h)

[Questa API non è supportata e può essere modificata o non disponibile in futuro. Le applicazioni devono evitare di usare la struttura MFVIDEOFORMAT e usare invece attributi di tipo multimediale. Per altre informazioni, vedere Tipi di supporti video.

Inizializza una struttura MFVIDEOFORMAT per un formato video standard, ad esempio DVD, televisione analogica o televisione digitale ATSC.

Sintassi

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

Parametri

[out] pVideoFormat

Puntatore a una struttura MFVIDEOFORMAT . La funzione riempie i membri della struttura in base al formato video specificato nel parametro di tipo.

[in] type

Formato video, specificato come membro dell'enumerazione MFStandardVideoFormat .

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Esempio

Nell'esempio seguente viene creato un oggetto tipo di supporto per un formato video 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;
}

Requisiti

Vedi anche

Funzioni di Media Foundation

Tipi di supporti

Tipi di supporti video