Microsoft DirectX 8.1 (C++)

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.

See Also