IEnumMediaTypes interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
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.
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.
Inheritance
The IEnumMediaTypes interface inherits from the IUnknown interface. IEnumMediaTypes also has these types of members:
Methods
The IEnumMediaTypes interface has these methods.
| IEnumMediaTypes::Clone The Clone method makes a copy of the enumerator. The returned object starts with the same enumeration state as the original. |
| IEnumMediaTypes::Next The Next method retrieves a specified number of media types. |
| IEnumMediaTypes::Reset The Reset method resets the enumeration sequence to the beginning. (IEnumMediaTypes.Reset) |
| IEnumMediaTypes::Skip The Skip method skips over a specified number of media types. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |