função MFInitVideoFormat_RGB (mfapi.h)

[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 RGB descompactado.

Sintaxe

HRESULT MFInitVideoFormat_RGB(
  [in] MFVIDEOFORMAT *pVideoFormat,
  [in] DWORD         dwWidth,
  [in] DWORD         dwHeight,
  [in] DWORD         D3Dfmt
);

Parâmetros

[in] pVideoFormat

Um ponteiro para uma estrutura MFVIDEOFORMAT . As funções preenchem os membros da estrutura com as informações de formato.

[in] dwWidth

A largura do vídeo, em pixels.

[in] dwHeight

A altura do vídeo, em pixels.

[in] D3Dfmt

Um valor D3DFORMAT que especifica o formato RGB.

Retornar valor

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

Comentários

Essa função preenche alguns valores padrão razoáveis para o formato RGB especificado.

Os desenvolvedores são incentivados a usar atributos de tipo de mídia em vez de usar a estrutura MFVIDEOFORMAT . Consulte Atributos de tipo de mídia.

Em geral, você deve evitar chamar essa função. Se você souber todos os detalhes do formato, poderá preencher a estrutura MFVIDEOFORMAT sem essa função. Se você não souber todos os detalhes do formato, os atributos serão preferíveis ao uso da estrutura MFVIDEOFORMAT .

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.
 

Requisitos

Requisito Valor
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 descompactados

Tipos de mídia de vídeo