| Microsoft DirectX 9.0 |
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 Value
Returns S_OK if successful. Otherwise, returns an error code that may be one of the following values, or others not listed.
| Value | 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.
See Also