Share via

CBaseFilter::EnumPins

  • Article
 
Microsoft DirectShow 9.0

CBaseFilter::EnumPins

The EnumPins method enumerates the pins on this filter. This method implements the IBaseFilter::EnumPins method.

Syntax

  HRESULT EnumPins(
    IEnumPins **ppEnum
);

Parameters

ppEnum

Address of a variable that receives a pointer to the IEnumPins interface.

Return Value

Returns one of the following HRESULT values.

Value Description
S_OK Success
E_OUTOFMEMORY Insufficient memory
E_POINTER NULL pointer argument

Remarks

This method creates an instance of the CEnumPins base class, and returns a pointer to that object, of type IEnumPins. The CEnumPins class calls the filter's CBaseFilter::GetPin method to enumerate the pins on the filter.

If this method succeeds, the IEnumPins interface has an outstanding reference count. The caller must release the interface.

Requirements

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

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

See Also