Interfaz IDistributorNotify (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
La IDistributorNotify interfaz permite que se notifique a un distribuidor de complementos cuando cambie el gráfico de filtro.
Las aplicaciones nunca usan esta interfaz. Implemente esta interfaz si está escribiendo un distribuidor de complementos (PID) y desea que el PID reciba notificaciones de control y cambios en la composición de gráficos de filtros.
Filter Graph Manager consulta esta interfaz en los distribuidores de complementos que agrega. Si un PID expone esta interfaz, el Administrador de gráficos de filtros notifica al PID de cualquier cambio de estado llamando a métodos IDistributorNotify antes de llamar a los métodos IBaseFilter equivalentes en los filtros. El Administrador de gráficos de filtros también llama al método IDistributorNotify::NotifyGraphChange cada vez que agrega o quita un filtro, o cualquier cambio en las conexiones de patillas.
Durante una llamada a cualquier método IDistributorNotify , no contenga ninguna sección crítica que pueda mantener otra ruta de acceso de código que llame a métodos en el Administrador de gráficos de filtros. Si lo hace, podría dar lugar a un interbloqueo.
Herencia
La interfaz IDistributorNotify hereda de la interfaz IUnknown . IDistributorNotify también tiene estos tipos de miembros:
Métodos
La interfaz IDistributorNotify tiene estos métodos.
| IDistributorNotify::NotifyGraphChange Se llama al método NotifyGraphChange cuando cambia el conjunto de filtros del gráfico de filtros o cualquier cambio de conexiones de patillas. |
| IDistributorNotify::P ause Se llama al método Pause cuando el gráfico de filtro entra en un estado en pausa. |
| IDistributorNotify::Run Se llama al método Run cuando el gráfico de filtros entra en estado de ejecución. |
| IDistributorNotify::SetSyncSource Se llama al método SetSyncSource cuando se registra un nuevo reloj. |
| IDistributorNotify::Stop Se llama al método Stop cuando el gráfico de filtros entra en un estado detenido. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |