Interface IDistributorNotify (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.]
A IDistributorNotify interface permite que um distribuidor de plug-in seja notificado quando o grafo de filtro for alterado.
Os aplicativos nunca usam essa interface. Implemente essa interface se você estiver escrevendo um PID (distribuidor de plug-in) e quiser que o PID receba notificações de controle e alterações na composição de grafos de filtro.
O Gerenciador de Gráficos de Filtro consulta essa interface em todos os distribuidores de plug-in que ela agrega. Se um PID expor essa interface, o Gerenciador do Gráfico de Filtro notificará o PID de quaisquer alterações de estado chamando métodos IDistributorNotify antes de chamar os métodos IBaseFilter equivalentes nos filtros. O Gerenciador de Grafo de Filtro também chama o método IDistributorNotify::NotifyGraphChange sempre que adiciona ou remove um filtro ou qualquer alteração de conexões de pino.
Durante uma chamada para qualquer método IDistributorNotify , não mantenha nenhuma seção crítica que possa ser mantida por outro caminho de código que chame métodos no Gerenciador do Gráfico de Filtro. Isso pode resultar em um deadlock.
Herança
A interface IDistributorNotify herda da interface IUnknown . IDistributorNotify também tem estes tipos de membros:
Métodos
A interface IDistributorNotify tem esses métodos.
| IDistributorNotify::NotifyGraphChange O método NotifyGraphChange é chamado quando o conjunto de filtros no grafo de filtro é alterado ou qualquer conexão de pino é alterada. |
| IDistributorNotify::P ause O método Pause é chamado quando o grafo de filtro está entrando em um estado em pausa. |
| IDistributorNotify::Run O método Run é chamado quando o grafo de filtro está entrando em um estado de execução. |
| IDistributorNotify::SetSyncSource O método SetSyncSource é chamado quando um novo relógio é registrado. |
| IDistributorNotify::Stop O método Stop é chamado quando o grafo de filtro está entrando em um estado parado. |
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) |