CEnumPins Class

Microsoft DirectShow 9.0

CEnumPins Class

The CEnumPins class implements an enumerator for pins.

This class implements the IEnumPins interface. It calls the following CBaseFilter methods:

• CBaseFilter::GetPin: Retrieves a pin on the filter, referenced by a zero-based index.
• CBaseFilter::GetPinCount: Retrieves the total number of pins on the filter.
• CBaseFilter::GetPinVersion: Determines whether the pins have changed.

If the filter dynamically creates or destroys pins, it increments the pin version whenever the pins change. If the version number changes, the enumerator object is no longer synchronized with the filter. Once the enumerator is out of sync, the methods in CEnumPins return VFW_E_ENUM_OUT_OF_SYNC. Call the CEnumPins::Reset method to resynchronize the enumerator.

Requirements

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

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

Public Methods
CEnumPins	Constructor method.
~CEnumPins	Destructor method. Virtual.
IEnumPins Methods
Clone	Makes a copy of the enumerator with the same enumeration state.
Next	Retrieves a specified number of pins.
Reset	Resets the enumeration sequence to the beginning.
Skip	Skips over a specified number of pins.