Compartilhar via


Método IGraphConfigCallback::Reconfigure (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 Reconfigure método é um método de retorno de chamada passado para IGraphConfig::Reconfigure.

Sintaxe

HRESULT Reconfigure(
  PVOID pvContext,
  DWORD dwFlags
);

Parâmetros

pvContext

Valor passado no parâmetro pvContext do método IGraphConfig::Reconfigure.

dwFlags

Valor passado no parâmetro dwFlags do método IGraphConfig::Reconfigure.

Retornar valor

Retorna S_OK se tiver êxito. Caso contrário, retorna um valor HRESULT que indica a causa do erro.

Comentários

Se o aplicativo ou filtro chamar IGraphConfig::Reconfigure, você deverá implementar esse método e passá-lo como um retorno de chamada. O método IGraphConfig::Reconfigure obtém um bloqueio no grafo de filtro antes de chamar seu Reconfigure método. Em seguida, seu método manipula todos os outros detalhes da criação dinâmica de grafo.

Se esse método for bem-sucedido, IGraphConfig::Reconfigure tentará colocar todos os filtros no grafo novamente em um estado em execução. Se o método falhar, IGraphConfig::Reconfigure retornará qualquer código de erro retornado por esse método.

Esse método permite a recompilação de grafo especializada. Para obter uma abordagem mais simples para a criação dinâmica de grafo, consulte IGraphConfig::Reconnect.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [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

IGraphConfigCallback Interface