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

  • Artigo

Consulta se o objeto dá suporte a um tipo de mídia especificado.

Sintaxe

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

Parâmetros

[in] pMediaType

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

[out] ppMediaType

Recebe um ponteiro para a interface IMFMediaType do tipo de mídia correspondente mais próximo ou recebe o valor NULL. Se não for NULL, o chamador deverá liberar a interface. Este parâmetro pode ser NULL. Consulte Observações.

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_INVALIDMEDIATYPE
 O objeto não dá suporte a esse tipo de mídia.

Comentários

Se o objeto der suporte ao tipo de mídia fornecido em pMediaType, o método retornará S_OK. Para uma fonte de mídia, isso significa que a origem pode gerar dados que estejam em conformidade com esse tipo de mídia. Para um coletor de mídia, isso significa que o coletor pode receber dados que estejam em conformidade com esse tipo de mídia. Se o objeto não der suporte ao tipo de mídia, o método falhará.

O parâmetro ppMediaType é opcional. Se o método falhar, o objeto poderá usar ppMediaType para retornar um tipo de mídia que o objeto dá suporte e que corresponde de perto ao fornecido em pMediaType. Não há garantia de que o método retorne um tipo de mídia em ppMediaType. Se nenhum tipo for retornado, esse parâmetro receberá um ponteiro NULL . Se o método for bem-sucedido, esse parâmetro receberá um ponteiro NULL . Se o chamador definir ppMediaType como NULL, esse parâmetro será ignorado.

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.
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 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

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