Funzione MFInitVideoFormat (mfapi.h)

Articolo
03/15/2023

[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

Nota Prima di Windows 7, questa funzione è stata esportata da evr.dll. A partire da Windows 7, questa funzione viene esportata da mfplat.dll e evr.dll esporta una funzione stub che chiama in mfplat.dll. Per altre informazioni, vedere Modifiche alla libreria in Windows 7.

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


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Evr.lib
DLL	Mfplat.dll

Vedi anche

Funzioni di Media Foundation

Tipi di supporti

Tipi di supporti video

Condividi tramite