CEnumMediaTypes class
[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 CEnumMediaTypes class implements an enumerator for preferred media types.
This class implements the IEnumMediaTypes interface. It calls the following CBasePin methods:
- CBasePin::GetMediaType:Retrieves a media type, referenced by a zero-based index.
- CBasePin::GetMediaTypeVersion: Determines whether the set of preferred types has changed.
Whenever a pin alters its list of preferred media types, the pin increments the media-type version number. When this happens, the enumerator object is no longer synchronized with the pin, and the class methods return VFW_E_ENUM_OUT_OF_SYNC. Call the CEnumMediaTypes::Reset method to resynchronize the enumerator.
| Public Methods | Description |
|---|---|
| CEnumMediaTypes | Constructor method. |
| ~CEnumMediaTypes | Destructor method. Virtual. |
| IEnumMediaTypes Methods | Description |
| Clone | Makes a copy of the enumerator with the same enumeration state. |
| 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
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|