CTransformFilter::FindPin

  • Article
 
Microsoft DirectShow 9.0

CTransformFilter::FindPin

The FindPin method retrieves the pin with the specified identifier. This method implements the IBaseFilter::FindPin method.

Syntax

  HRESULT FindPin(
    LPCWSTR Id,
    IPin **ppPin
);

Parameters

Id

Wide-character string that contains the pin identifier.

ppPin

Receives a pointer to the pin's IPin interface. If the method fails, *ppPin is set to NULL.

Return Value

Returns one of the HRESULT values shown in the following table.

Value Description
S_OK Success.
E_OUTOFMEMORY Insufficient memory.
E_POINTER NULL pointer argument.
VFW_E_NOT_FOUND Could not find a pin with this identifier.

Remarks

The identifier for the input pin is In, and the identifier for the output pin is Out.

Requirements

**  Header:** Declared in Transfrm.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also