Método IMediaControl::AddSourceFilter (control.h)
[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 AddSourceFilter método adiciona um filtro de origem ao grafo de filtro.
Esse método destina-se ao uso por aplicativos do Visual Basic 6.0. Ele foi documentado para o Visual Basic 6.0 como o método FilgraphManager.AddSourceFilter . Em vez disso, os aplicativos C++ devem usar o método IGraphBuilder::AddSourceFilter .
Sintaxe
HRESULT AddSourceFilter(
[in] BSTR strFilename,
[out] IDispatch **ppUnk
);
Parâmetros
[in] strFilename
Especifica o nome do arquivo a ser carregado.
[out] ppUnk
Recebe um ponteiro para a interface IDispatch . O chamador deve liberar a interface . Você pode consultar o ponteiro retornado para a interface IFilterInfo .
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Requisitos
| Requisito | Valor |
|---|---|
| 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 | control.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |