Método IPin::ReceiveConnection (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 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.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Argumento de ponteiro NULL.
VFW_E_ALREADY_CONNECTED
 O pino já está conectado.
VFW_E_NOT_STOPPED
 Não é possível se conectar enquanto o filtro estiver ativo.
VFW_E_TYPE_NOT_ACCEPTED
 O tipo de mídia especificado não é aceitável.

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:

Se a conexão for inadequada, o pin deverá retornar um código de erro.

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

   
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

Como os filtros se conectam

IPin Interface