Método IGraphBuilder::Render (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O Render método cria um grafo de filtro que renderiza os dados de um pin de saída especificado.

Sintaxe

HRESULT Render(
  [in] IPin *ppinOut
);

Parâmetros

[in] ppinOut

Ponteiro para a interface IPin em um pino de saída.

Retornar valor

Retorna um HRESULT. Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
VFW_S_AUDIO_NOT_RENDERED
 Êxito parcial; o áudio não foi renderizado.
VFW_S_DUPLICATE_NAME
 Sucesso; o Gerenciador de Grafo de Filtro modificou um nome de filtro para evitar a duplicação.
VFW_S_PARTIAL_RENDER
 Êxito parcial; alguns dos fluxos neste filme estão em um formato sem suporte.
VFW_S_VIDEO_NOT_RENDERED
 Êxito parcial; o vídeo não foi renderizado.
E_ABORT
 Operação anulada.
E_OUTOFMEMORY
 Memória insuficiente.
E_POINTER
 Argumento de ponteiro NULL.
VFW_E_CANNOT_CONNECT
 Não foi encontrada nenhuma combinação de filtros intermediários para fazer a conexão.
VFW_E_CANNOT_RENDER
 Nenhuma combinação de filtros foi encontrada para renderizar o fluxo.
VFW_E_NO_ACCEPTABLE_TYPES
 Não há nenhum tipo de mídia comum entre esses pinos.
VFW_E_NOT_IN_GRAPH
 O filtro ao qual esse pino pertence não está no grafo de filtro.

Comentários

Esse método renderiza os dados de um pino de saída especificado, adicionando novos filtros ao grafo conforme necessário. Os filtros são testados na mesma ordem que para o método IGraphBuilder::Connect . Para obter mais informações, confira Conexão Inteligente.

Durante o processo de conexão, o Gerenciador do Grafo de Filtro ignorará os pinos em filtros intermediários se o nome do pino começar com um bloco (~). Para obter mais informações, consulte PIN_INFO.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IGraphBuilder Interface