Share via


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