IEnumMediaTypes Interface

 
Microsoft DirectShow 9.0

IEnumMediaTypes Interface

The IEnumMediaTypes interface enumerates a pin's preferred media types. To obtain this interface, call the IPin::EnumMediaTypes method on the pin. Filters use this interface when they connect to other filters. Applications can also use it to examine a pin's preferred media types. For more information, see Enumerating Objects in a Filter Graph.

This interface implements a standard Component Object Model (COM) collection object. For more information on COM collections, see the IEnumXXXX topic in the Platform SDK.

If a pin's set of preferred media types changes, some methods on this interface return VFW_E_ENUM_OUT_OF_SYNC. Call the IEnumMediaTypes::Reset method to resynchronize the enumerator.

In addition to the methods inherited from IUnknown, the IEnumMediaTypes interface exposes the following methods.

Method Description
Clone Makes a copy of the enumerator.
Next Retrieves a specified number of media types.
Reset Resets the enumeration sequence to the beginning.
Skip Skips over a specified number of media types.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.