CBasePin::Connect

9/8/2008

Inicia uma conexão deste pino para o outro pino.

Syntax

HRESULT Connect(
  IPin* pReceivePin,
  const AM_MEDIA_TYPE* pmt
);

Parameters

• pReceivePin
  Pino de entrada para conectar ao.

• Pgto
  Parâmetro opcional tipo de mídia.

Return Value

Retorna um do seguinte argumentos Por padrão; Se substituído, deve retornar padrão HRESULT Os valores.

Valor	Descrição
VFW_E_ALREADY_CONNECTED	Este pino saída já está conectado a outro pino.
VFW_E_NOT_STOPPED	O filtro gráfico não está em um estado parado e a conexão não pode ser executada.
Outro valor de erro	Retornado de CBasePin::AgreeMediaType Ou CBasePin::CheckConnect ou substituídas versões dessas funções membro.

Remarks

Essa função membro implementa o IPin::Connect método.

IPin::Connect é implementada no pino saída e chamadas de IPin::ReceiveConnection método para a entrada conectada pino (implementado nas classes de base como CBasePin::ReceiveConnection).

Essa função membro chama o Virtual CBasePin::CheckConnect função membro, que pode ser substituída para verificar que a conexão é possível. CBasePin::CheckConnect Em seguida, chama CBasePin::AgreeMediaType Para negociar uma comum tipo de mídia com o pino conectado.

CBasePin::AgreeMediaType Chamadas CBasePin::TryMediaTypes Duas vezes, uma vez para enumerador tipo de mídia deste pino e uma vez para enumerador tipo de mídia do pino de recebimento.

Para cada tipo de mídia encontrado, CBasePin::AttemptConnection é chamado, que chama in TURN do pino de recebimento IPin::ReceiveConnection método e finalmente CBasePin::CompleteConnect Se bem-sucedido.

Requirements

Windows Embedded CE	Windows CE 2.12 and later
Windows Mobile	Windows Mobile Version 5.0 and later
Note	Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later