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

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.

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

Confira também

IMFMediaTypeHandler