Método IPin::ReceiveConnection (strmif.h)

[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 ReceiveConnection método aceita uma conexão de outro pin.

Os aplicativos não devem chamar esse método. Esse método é chamado por outros filtros durante o processo de conexão de pino.

Sintaxe

HRESULT ReceiveConnection(
  [in] IPin                *pConnector,
  [in] const AM_MEDIA_TYPE *pmt
);

Parâmetros

[in] pConnector

Ponteiro para a interface IPin do pino de conexão.

[in] pmt

Ponteiro para uma estrutura AM_MEDIA_TYPE que especifica o tipo de mídia para a conexão.

Retornar valor

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

Comentários

Quando um pino de saída se conecta, ele chama esse método no pin de entrada. O pin de entrada deve verificar se o tipo de mídia especificado é aceitável. Também pode precisar marcar para outros requisitos de conexão específicos para o filtro proprietário. Se a conexão for adequada, o pino de entrada deverá retornar S_OK e também fazer o seguinte:

• Armazene o tipo de mídia e retorne o mesmo tipo no método IPin::ConnectionMediaType .
• Armazene a interface IPin do pino de saída (pConnector) e retorne esse ponteiro no método IPin::ConnectedTo .

A classe CBasePin implementa a estrutura básica para esse método, incluindo o armazenamento do tipo de mídia e dos ponteiros IPin .

Requisitos

Confira também

Códigos de erro e êxito

Como os filtros se conectam

IPin Interface