Compartilhar via


Método IMFTopologyNode::GetInputPrefType (mfidl.h)

Recupera o tipo de mídia preferencial para um fluxo de entrada neste nó.

Sintaxe

HRESULT GetInputPrefType(
  [in]  DWORD        dwInputIndex,
  [out] IMFMediaType **ppType
);

Parâmetros

[in] dwInputIndex

Índice baseado em zero do fluxo de entrada.

[out] ppType

Recebe um ponteiro para a interface IMFMediaType do tipo de mídia. 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.
E_FAIL
Esse nó não tem um tipo de entrada preferencial.
E_INVALIDARG
Índice de fluxo inválido.
E_NOTIMPL
Esse nó é um nó de origem.

Comentários

Nós de origem não podem ter entradas. Se esse método for chamado em um nó de origem, ele retornará E_NOTIMPL.

O tipo de entrada preferencial fornece uma dica para o carregador de topologia. Em uma topologia totalmente resolvida, não há garantia de que cada nó de topologia terá um tipo de entrada preferencial. Para obter o tipo de mídia real de um nó, você deve obter um ponteiro para o objeto subjacente do nó. (Para obter mais informações, consulte MF_TOPOLOGY_TYPE enumeração.)

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 mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFTopologyNode

Topologias