Edit

IMFMediaSource interface (mfidl.h)

  • Article

Implemented by media source objects.

Media sources are objects that generate media data. For example, the data might come from a video file, a network stream, or a hardware device, such as a camera. Each media source contains one or more streams, and each stream delivers data of one type, such as audio or video.

Inheritance

The IMFMediaSource interface inherits from IMFMediaEventGenerator. IMFMediaSource also has these types of members:

Methods

The IMFMediaSource interface has these methods.

 
IMFMediaSource::CreatePresentationDescriptor

Retrieves a copy of the media source's presentation descriptor. Applications use the presentation descriptor to select streams and to get information about the source content.
IMFMediaSource::GetCharacteristics

Retrieves the characteristics of the media source.
IMFMediaSource::Pause

Pauses all active streams in the media source.
IMFMediaSource::Shutdown

Shuts down the media source and releases the resources it is using.
IMFMediaSource::Start

Starts, seeks, or restarts the media source by specifying where to start playback.
IMFMediaSource::Stop

Stops all active streams in the media source.

Remarks

In Windows 8, this interface is extended with IMFMediaSourceEx.

For some device sources, such as cameras or microphones, the IMFMediaSource also implements the IKsControl which can be used by user mode applications to issue KSPROPERTY, KSEVENT and KSMETHOD operations to the underlying device driver.

Note

This interface is optional and may not be available. If this interface is not available, QueryInterface will return E_NOINTERFACE.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h

See also

IMFMediaEventGenerator

Media Foundation Interfaces

Media Sources