Microsoft Windows CE 3.0  

CEnumPins Class

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This class supports the IEnumPinsenumeration interface by calling CBaseFiltermethods. The CBaseFilterclass supports the IBaseFilter::EnumPinsmethod. Each time one of this interface's methods is called, the CBaseFilterclass checks to see if the pins that it enumerates have changed; it does this by calling CBaseFilter::GetPinVersionand matching the version the filter is keeping with the version that it stores during construction.

If a pin enumerator becomes stale, there is no mechanism for resynchronizing it with the filter. The user must release the interface and retrieve another one.

Because the enumeration operation is likely to fail if the pin version changes (indicating that the filter might have added or removed pins), all member functions in this class check the version by calling a private member function, which calls the owning filter's CBaseFilter::GetPinVersionmember function. These member functions then return VFW_E_ENUM_OUT_OF_SYNCif the version has changed. This should always work unless the filter has overridden CBaseFilter::GetPinVersionto do something unexpected.

All member functions in this class that return HRESULTand accept a pointer as a parameter return E_POINTER when passed a null pointer.

Member Functions

CEnumPins Constructs a CEnumPinsobject.

Implemented IUnknown Methods

AddRef Increments the reference count.
QueryInterface Returns pointers to supported interfaces.
Release Decrements the reference count.

Implemented IEnumPins Methods

Clone Creates a duplicate CEnumPinsobject with the same initial state.
Next Returns the next pin after the current position.
Reset Sets the current position back to the beginning.
Skip Skips over one or more entries in the enumerator.