Compartilhar via


Método IRenderEngine::GetGroupOutputPin

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

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O GetGroupOutputPin método recupera o pino de saída do grupo especificado.

Sintaxe

HRESULT GetGroupOutputPin(
        long Group,
  [out] IPin **ppRenderPin
);

Parâmetros

Grupo

Índice baseado em zero que especifica o grupo.

ppRenderPin [out]

Recebe um ponteiro para a interface IPin do pino de saída.

Retornar valor

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

Código de retorno Descrição
S_FALSE
O grupo não tem um pino de saída.
S_OK
Êxito.
E_INVALIDARG
Argumento inválido.
E_MUST_INIT_RENDERER
Falha ao inicializar o mecanismo de renderização.
E_POINTER
Ponteiro inválido.
E_RENDER_ENGINE_IS_BROKEN
Falha na operação porque o projeto não foi renderizado com êxito.
E_UNEXPECTED
Erro inesperado.

 

Comentários

Antes de chamar esse método, chame IRenderEngine::ConnectFrontEnd para criar o front-end do grafo. Cada grupo representa um único fluxo de mídia e o front-end tem um pino de saída correspondente.

Você pode usar esse método para criar a parte de renderização de um grafo de gravação de arquivo. Conecte os pinos de saída a filtros multiplexer e filtros de gravador de arquivos. Para obter mais informações, consulte Renderizando um projeto.

Para visualização, você não precisa chamar esse método. Basta chamar ConnectFrontEnd seguido por IRenderEngine::RenderOutputPins.

Se o método retornar S_OK, a interface IPin retornada terá uma contagem de referência pendente. Certifique-se de liberar a interface quando terminar de usá-la.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito Valor
parâmetro
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IRenderEngine Interface

Códigos de erro e êxito