CPullPin::Active
Microsoft DirectShow 9.0 |
CPullPin::Active
The Active method creates a worker thread that pulls data from the output pin. This method also commits the allocator.
Syntax
HRESULT Active(void);
Parameters
This method takes no parameters.
Return Values
Returns an HRESULT value. Possible values include the following.
Return code | Description |
S_OK | Success. |
E_UNEXPECTED | The pin connection was not established correctly. |
E_FAIL | Could not create the thread, or the thread already exists. |
Remarks
Call this method when the owning filter becomes active. (If your input pin derives from CBasePin, override the CBasePin::Active method.)
Before calling this method, call the CPullPin::Connect method to establish the connection with the output pin.
Requirements
** Header:** Include Pullpin.h and Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also