Função MFInitVideoFormat (mfapi.h)

  • Artigo

[Essa API não tem suporte e pode ser alterada ou indisponível no futuro. Os aplicativos devem evitar o uso da estrutura MFVIDEOFORMAT e usar atributos de tipo de mídia. Para obter mais informações, consulte Tipos de mídia de vídeo.]

Inicializa uma estrutura MFVIDEOFORMAT para um formato de vídeo padrão, como DVD, televisão analógica ou televisão digital ATSC.

Sintaxe

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

Parâmetros

[out] pVideoFormat

Um ponteiro para uma estrutura MFVIDEOFORMAT . A função preenche os membros da estrutura com base no formato de vídeo especificado no parâmetro type.

[in] type

O formato de vídeo, especificado como um membro da enumeração MFStandardVideoFormat .

Valor retornado

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Nota Antes do Windows 7, essa função era exportada de evr.dll. A partir do Windows 7, essa função é exportada de mfplat.dll e evr.dll exporta uma função stub que chama para mfplat.dll. Para obter mais informações, consulte Alterações de biblioteca no Windows 7.
 

Exemplos

O exemplo a seguir cria um objeto de tipo de mídia para um formato de vídeo padrão.

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

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Evr.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation

Tipos de mídia

Tipos de mídia de vídeo