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