CSource::FindPin

Microsoft DirectShow 9.0

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

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

Additional resources