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 |
|---|---|
|
O grupo não tem um pino de saída. |
|
Êxito. |
|
Argumento inválido. |
|
Falha ao inicializar o mecanismo de renderização. |
|
Ponteiro inválido. |
|
Falha na operação porque o projeto não foi renderizado com êxito. |
|
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 |
|
| Biblioteca |
|
Confira também