Compartilhar via


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)

Confira também

Distribuidores de plug-in