CPullPin.Active method

The Active method creates a worker thread that pulls data from the output pin. This method also commits the allocator.

Syntax

HRESULT Active();

Parameters

This method has no parameters.

Return value

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
Pullpin.h
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

CPullPin Class