Método IGraphConfig::P ushThroughData (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.
El PushThroughData método inserta datos a través del gráfico de filtro en la patilla especificada.
Sintaxis
HRESULT PushThroughData(
[in] IPin *pOutputPin,
[in] IPinConnection *pConnection,
[in] HANDLE hEventAbort
);
Parámetros
[in] pOutputPin
Puntero a la interfaz IPin de un pin de salida en el gráfico de filtros.
[in] pConnection
Puntero a la interfaz IPinConnection de un pin de entrada en el gráfico de filtros. Este parámetro puede ser NULL.
[in] hEventAbort
Identificador para un evento. Si el autor de la llamada es un filtro que llama a en uno de sus subprocesos de procesamiento de datos, este parámetro debe ser un identificador de un evento que se indicará cuando el filtro se coloque en un estado detenido. De lo contrario, este parámetro puede ser NULL. Para obtener más información, vea la sección Comentarios.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente. De lo contrario, devuelve un código de error que puede ser uno de los valores siguientes u otros no enumerados.
| Código devuelto | Descripción |
|---|---|
|
No se pudo asignar la memoria necesaria. |
|
No se encontró un pin de entrada candidato. |
|
El estado del filtro ha cambiado durante la operación. |
Observaciones
Este método inserta los datos pendientes desde un pin de salida especificado hasta un pin de entrada especificado. Opcionalmente, puede dejar sin especificar el pin de entrada y dejar que el método busque el gráfico de filtros para obtener el mejor candidato. No llame a este método desde el subproceso que inserta datos.
Si un filtro llama a este método en uno de sus propios subprocesos de procesamiento de datos, crea la posibilidad de un interbloqueo. El método obtiene un bloqueo en el gráfico de filtros, que puede impedir que el filtro se detenga al recibir una llamada a IMediaFilter::Stop. Para evitar esta situación, el método toma un identificador a un objeto de evento proporcionado por el filtro. El filtro debe indicar el evento si recibe una llamada a su método Stop .
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |