Método IMFMediaTypeHandler::GetMediaTypeByIndex (mfidl.h)

  • Artigo

Recupera um tipo de mídia da lista de tipos de mídia com suporte do objeto.

Sintaxe

HRESULT GetMediaTypeByIndex(
  [in]  DWORD        dwIndex,
  [out] IMFMediaType **ppType
);

Parâmetros

[in] dwIndex

Índice baseado em zero do tipo de mídia a ser recuperado. Para obter o número de tipos de mídia na lista, chame IMFMediaTypeHandler::GetMediaTypeCount.

[out] ppType

Recebe um ponteiro para a interface IMFMediaType . O chamador deve liberar a interface.

Valor retornado

O método 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
 O método foi bem-sucedido.
MF_E_NO_MORE_TYPES
 O parâmetro dwIndex está fora do intervalo.

Comentários

Os tipos de mídia são retornados na ordem aproximada de preferência. Não há garantia de que a lista de tipos com suporte seja concluída. Para testar se há suporte para um tipo de mídia específico, chame IMFMediaTypeHandler::IsMediaTypeSupported.

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFMediaTypeHandler