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).