CSource::FindPin

  • Article
 
Microsoft DirectShow 9.0

CSource::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

Pointer to a null-terminated string that identifies the pin.

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_POINTER NULL pointer argument.
VFW_E_NOT_FOUND Could not find a pin with this identifier.

Remarks

The first pin is always named "1"; the second pin is named "2"; and so forth. For more information, see CSourceStream::QueryId.

Requirements

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

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

See Also