Método CBaseFilter.JoinFilterGraph

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 JoinFilterGraph método notifica o filtro de que ele ingressou ou deixou um grafo de filtro. Esse método implementa o método IBaseFilter::JoinFilterGraph .

Sintaxe

HRESULT JoinFilterGraph(
       IFilterGraph *pGraph,
  [in] LPCWSTR      pName
);

Parâmetros

pGraph

Ponteiro para a interface IFilterGraph do gerenciador de grafo de filtro ou NULL se o filtro estiver saindo do grafo.

pName [in]

Ponteiro para uma cadeia de caracteres Unicode que contém um nome para o filtro.

Retornar valor

Returns S_OK.

Comentários

Esse método define a variável de membro CBaseFilter::m_pGraph igual ao parâmetro pGraph . Ele também consulta um ponteiro de interface IMediaEventSink e o armazena na variável de membro CBaseFilter::m_pSink . No entanto, o filtro não mantém uma contagem de referência em nenhuma dessas interfaces. Isso criaria uma contagem de referência circular, pois o gerenciador de grafo de filtro mantém uma contagem de referência no filtro.

O método copia a cadeia de caracteres especificada por pName para a variável de membro CBaseFilter::m_pName .

Requisitos

Requisito Valor
parâmetro
Amfilter.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseFilter