Função MFInitAMMediaTypeFromMFMediaType (mfapi.h)

Inicializa uma estrutura de AM_MEDIA_TYPE do DirectShow de um tipo de mídia do Media Foundation.

Sintaxe

HRESULT MFInitAMMediaTypeFromMFMediaType(
  IMFMediaType  *pMFType,
  GUID          guidFormatBlockType,
  AM_MEDIA_TYPE *pAMType
);

Parâmetros

pMFType

Ponteiro para a interface IMFMediaType do tipo de mídia a ser convertida.

guidFormatBlockType

Guid de tipo de formato. Esse valor corresponde ao membro formattype da estrutura AM_MEDIA_TYPE e especifica o tipo de bloco de formato a ser alocado. Se o valor for GUID_NULL, a função tentará deduzir o bloco de formato correto, com base no tipo principal e no subtipo.

pAMType

Ponteiro para uma estrutura AM_MEDIA_TYPE . A função aloca memória para o bloco de formato. O chamador deve liberar o bloco de formato chamando CoTaskMemFree no membro pbFormat .

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
A função foi bem-sucedida.
MF_E_INVALIDMEDIATYPE
O tipo de mídia não é válido.

Comentários

Essa função também pode ser usada com as seguintes estruturas de formato equivalentes a AM_MEDIA_TYPE:

  • DMO_MEDIA_TYPE (Objetos de Mídia DirectX)
  • WM_MEDIA_TYPE (SDK de Formato de Mídia do Windows)

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 Mfplat.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation