IGraphConfig::PushThroughData

  • Articolo
 
Microsoft DirectShow 9.0

IGraphConfig::PushThroughData

The PushThroughData method pushes data through the filter graph to the specified pin.

Syntax

  HRESULT PushThroughData(
  IPin *pOutputPin,
  IPinConnection *pConnection,
  HANDLE hEventAbort
);

Parameters

pOutputPin

[in] Pointer to an output pin in the filter graph.

pConnection

[in] Pointer to an input pin in the filter graph, or NULL.

hEventAbort

[in] Handle to an event. If the caller is a filter calling on one of its data processing threads, this parameter should be a handle to an event that will be signaled when the filter is put into a stopped state. Otherwise, this parameter can be NULL. For more information, see Remarks.

Return Values

Returns S_OK if successful. Otherwise, returns an error code that may be one of the following values, or others not listed.

Return code Description
E_OUTOFMEMORY Failed to allocate necessary memory.
VFW_E_NOT_FOUND Could not find a candidate input pin.
VFW_E_STATE_CHANGED Filter state changed during the operation.

Remarks

This method pushes through any pending data, from a specified output pin down to a specified input pin. Optionally, you can leave the input pin unspecified and let the method search the filter graph for the best candidate. Do not call this method from the thread that is pushing data.

If a filter calls this method on one of its own data processing threads, it creates the potential for a deadlock. The method obtains a lock on the filter graph, which can block the filter from stopping on receiving a call to IMediaFilter::Stop. To prevent this situation, the method takes a handle to an event object provided by the filter. The filter should signal the event if it receives a call to its Stop method.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also