Método ICaptureGraphBuilder2::GetFiltergraph (strmif.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 GetFiltergraph
método recupera o grafo de filtro que o construtor de grafo de captura está usando.
Sintaxe
HRESULT GetFiltergraph(
[out] IGraphBuilder **ppfg
);
Parâmetros
[out] ppfg
Recebe um ponteiro de interface IGraphBuilder .
Retornar valor
Retorna um dos seguintes valores HRESULT .
Código de retorno | Descrição |
---|---|
|
Êxito. |
|
Argumento de ponteiro NULL. |
|
Nenhum grafo de filtro. |
Comentários
Inicialmente, o construtor de grafo de captura não contém um ponteiro para um grafo de filtro. Esse método retorna E_UNEXPECTED até que um dos seguintes métodos tenha sido chamado:
- ICaptureGraphBuilder2::RenderStream
- ICaptureGraphBuilder2::SetFiltergraph
- ICaptureGraphBuilder2::SetOutputFileName
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 | strmif.h (inclua Dshow.h) |
Biblioteca | Strmiids.lib |