Share via


Legacy Microsoft Media Foundation APIs

Headers associated with legacy features of the Microsoft Media Foundation technology.

The following headers support legacy features for Microsoft Media Foundation:

For programming guidance for this technology, see:

Enumerations

 
_MFP_CREATION_OPTIONS

Specifies options for the MFPCreateMediaPlayer function.
_MFP_CREDENTIAL_FLAGS

Contains flags for the MFP_ACQUIRE_USER_CREDENTIAL_EVENT structure.
_MFP_MEDIAITEM_CHARACTERISTICS

Contains flags that describe a media item.
EVRFilterConfigPrefs

Contains flags that are used to configure the Microsoft DirectShow enhanced video renderer (EVR) filter.
MFP_EVENT_TYPE

Defines event types for the IMFPMediaPlayerCallback interface.
MFP_MEDIAPLAYER_STATE

Specifies the current playback state.
MFVideoAlphaBitmapFlags

Defines flags for the MFVideoAlphaBitmapParams structure.
MFVideoAspectRatioMode

Specifies the aspect-ratio mode.
MFVideoMixPrefs

Contains flags that are used to configure how the enhanced video renderer (EVR) performs deinterlacing.
MFVideoRenderPrefs

Contains flags that define how the enhanced video renderer (EVR) displays the video.
MFVP_MESSAGE_TYPE

Defines messages for an enhanced video renderer (EVR) presenter.

Functions

 
CanConstrict

Queries whether the plug-in can limit the effective video resolution.
Clear

Clears the time stamps previously set by a call to IMFDesiredSample::SetDesiredSampleTimeAndDuration.
ClearAlphaBitmap

Removes the current bitmap and releases any resources associated with it.
ClearMediaItem

Clears the current media item.
CreateMediaItemFromObject

Creates a media item from an object.
CreateMediaItemFromURL

Creates a media item from a URL.
DisableImageExport

Enables or disables the ability of the plug-in to export the video image.
FrameStep

Steps forward one video frame.
GetAlphaBitmapParameters

Retrieves the current settings that the enhanced video renderer (EVR) uses to alpha-blend the bitmap with the video.
GetAspectRatioMode

Queries how the enhanced video renderer (EVR) handles the aspect ratio of the source video.
GetAspectRatioMode

Gets the current aspect-ratio correction mode. This mode controls whether the aspect ratio of the video is preserved during playback.
GetAvailableVideoProcessorModes

Retrieves the video processor modes that the video driver supports.
GetBackgroundColor

Retrieves the background color for the composition rectangle. The background color is used for letterboxing the video image.
GetBalance

Gets the current audio balance.
GetBorderColor

Gets the border color for the video.
GetBorderColor

Gets the current color of the video border.
GetCharacteristics

Gets various flags that describe the media item.
GetConfigPrefs

Gets the configuration parameters for the Microsoft DirectShow Enhanced Video Renderer Filter filter.
GetCurrentImage

Gets a copy of the current image being displayed by the video renderer.
GetCurrentMediaType

Retrieves the presenter's media type.
GetDesiredSampleTimeAndDuration

Called by the mixer to get the time and duration of the sample requested by the presenter.
GetDeviceID

Returns the identifier of the video device supported by an EVR mixer or presenter.
GetDuration

Gets the duration of the media item.
GetDuration

Gets the playback duration of the current media item.
GetFilteringRange

Retrieves the range of values for a specified image filter setting.
GetFilteringValue

Retrieves the current setting for an image filter.
GetFullscreen

Queries whether the enhanced video renderer (EVR) is currently in full-screen mode.
GetIdealVideoSize

Gets the range of sizes that the enhanced video renderer (EVR) can display without significantly degrading performance or image quality.
GetIdealVideoSize

Gets the range of video sizes that can be displayed without significantly degrading performance or image quality.
GetMediaItem

Gets a pointer to the current media item.
GetMediaPlayer

Gets a pointer to the MFPlay player object that created the media item.
GetMetadata

Gets a property store that contains metadata for the source, such as author or title.
GetMixingPrefs

Gets the current preferences for video deinterlacing.
GetMute

Queries whether the audio is muted. (IMFPMediaPlayer.GetMute)
GetNativeVideoSize

Gets the size and aspect ratio of the video, prior to any stretching by the video renderer.
GetNativeVideoSize

Gets the size and aspect ratio of the video.
GetNumberOfStreams

Retrieves the number of input pins on the EVR filter. The EVR filter always has at least one input pin, which corresponds to the reference stream.
GetNumberOfStreams

Gets the number of streams (audio, video, and other) in the media item.
GetObject

Gets the object that was used to create the media item.
GetPosition

Gets the current playback position. (IMFPMediaPlayer.GetPosition)
GetPresentationAttribute

Queries the media item for a presentation attribute.
GetProcAmpRange

Retrieves the range of values for a color adjustment (ProcAmp) setting.
GetProcAmpValues

Retrieves the current settings for one or more color adjustment (ProcAmp) settings.
GetRate

Gets the current playback rate. (IMFPMediaPlayer.GetRate)
GetRenderingPrefs

Gets various video rendering settings.
GetStartStopPosition

Gets the start and stop times for the media item.
GetState

Gets the current playback state of the MFPlay player object.
GetStreamActiveState

IEVRVideoStreamControl::GetStreamActiveState method
GetStreamAttribute

Queries the media item for a stream attribute.
GetStreamOutputRect

Retrieves the position of a video stream within the composition rectangle.
GetStreamSelection

Queries whether a stream is selected to play. (IMFPMediaItem.GetStreamSelection)
GetStreamZOrder

Retrieves the z-order of a video stream.
GetSupportedRates

Gets the range of supported playback rates.
GetURL

Gets the URL that was used to create the media item.
GetUserData

Gets the application-defined value stored in the media item.
GetVideoPosition

Gets the source and destination rectangles for the video.
GetVideoProcessorCaps

Retrieves the capabilities of a video processor mode.
GetVideoProcessorMode

Retrieves the application's preferred video processor mode. To set the preferred mode, call IMFVideoProcessor::SetVideoProcessorMode.
GetVideoSourceRect

Gets the video source rectangle.
GetVideoWindow

Gets the clipping window for the video.
GetVideoWindow

Gets the window where the video is displayed.
GetVolume

Gets the current audio volume.
HasAudio

Queries whether the media item contains an audio stream.
HasVideo

Queries whether the media item contains a video stream.
InitializeRenderer

Sets a new mixer or presenter for the enhanced video renderer (EVR).
InitServicePointers

Signals the mixer or presenter to query the enhanced video renderer (EVR) for interface pointers.
InsertEffect

Applies an audio or video effect to playback.
IsInTrustedVideoMode

Queries whether the plug-in has any transient vulnerabilities at this time.
IsProtected

Queries whether the media item contains protected content.
LookupService

Retrieves an interface from the enhanced video renderer (EVR), or from the video mixer or video presenter.
MapOutputCoordinateToInputStream

Maps output image coordinates to input image coordinates.
MFCreateVideoMixer

Creates the default video mixer for the enhanced video renderer (EVR).
MFCreateVideoMixerAndPresenter

Creates the default video mixer and video presenter for the enhanced video renderer (EVR).
MFCreateVideoPresenter

Creates the default video presenter for the enhanced video renderer (EVR).
MFCreateVideoRenderer

Creates an instance of the enhanced video renderer (EVR) media sink.
MFCreateVideoSampleAllocator

Creates an object that allocates video samples.
MFCreateVideoSampleFromSurface

Creates a media sample that manages a Direct3D surface.
MFP_GET_ACQUIRE_USER_CREDENTIAL_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_ACQUIRE_USER_CREDENTIAL_EVENT pointer.
MFP_GET_ERROR_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_ERROR_EVENT pointer.
MFP_GET_FRAME_STEP_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_FRAME_STEP_EVENT pointer.
MFP_GET_MEDIAITEM_CLEARED_EVENT

Casts an MFP_EVENT_HEADER pointer to an MEDIAITEM_CLEARED_EVENT pointer.
MFP_GET_MEDIAITEM_CREATED_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_MEDIAITEM_CREATED_EVENT pointer.
MFP_GET_MEDIAITEM_SET_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_MEDIAITEM_SET_EVENT pointer.
MFP_GET_MF_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_MF_EVENT pointer.
MFP_GET_PAUSE_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_PAUSE_EVENT pointer.
MFP_GET_PLAY_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_PLAY_EVENT pointer.
MFP_GET_PLAYBACK_ENDED_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_PLAYBACK_ENDED_EVENT pointer.
MFP_GET_POSITION_SET_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_POSITION_SET_EVENT pointer.
MFP_GET_RATE_SET_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_RATE_SET_EVENT pointer.
MFP_GET_STOP_EVENT

Casts an MFP_EVENT_HEADER pointer to an MFP_STOP_EVENT pointer.
MFPCreateMediaPlayer

Creates a new instance of the MFPlay player object.
OnMediaPlayerEvent

Called by the MFPlay player object to notify the application of a playback event.
Pause

Pauses playback. (IMFPMediaPlayer.Pause)
Play

Starts playback. (IMFPMediaPlayer.Play)
ProcessMessage

Sends a message to the video presenter. Messages are used to signal the presenter that it must perform some action, or that some event has occurred.
ReleaseServicePointers

Signals the object to release the interface pointers obtained from the enhanced video renderer (EVR).
RemoveAllEffects

Removes all effects that were added with the IMFPMediaPlayer::InsertEffect method.
RemoveEffect

Removes an effect that was added with the IMFPMediaPlayer::InsertEffect method.
RepaintVideo

Repaints the current video frame. Call this method whenever the application receives a WM_PAINT message.
SetAlphaBitmap

Sets a bitmap image for the enhanced video renderer (EVR) to alpha-blend with the video.
SetAspectRatioMode

Specifies how the enhanced video renderer (EVR) handles the aspect ratio of the source video.
SetAspectRatioMode

Specifies whether the aspect ratio of the video is preserved during playback.
SetBackgroundColor

Sets the background color for the composition rectangle. The background color is used for letterboxing the video image.
SetBalance

Sets the audio balance. (IMFPMediaPlayer.SetBalance)
SetBorderColor

Sets the border color for the video.
SetBorderColor

Sets the color for the video border.
SetConfigPrefs

Sets the configuration parameters for the Microsoft DirectShow Enhanced Video Renderer Filter (EVR).
SetConstriction

Limits the effective video resolution.
SetDesiredSampleTimeAndDuration

Called by the presenter to set the time and duration of the sample that it requests from the mixer.
SetFilteringValue

Sets a parameter for an image filter.
SetFullscreen

Sets or unsets full-screen rendering mode.
SetMediaItem

Queues a media item for playback.
SetMixingPrefs

Sets the preferences for video deinterlacing.
SetMute

Mutes or unmutes the audio. (IMFPMediaPlayer.SetMute)
SetNumberOfStreams

Sets the number of input pins on the EVR filter.
SetPosition

Sets the playback position.
SetProcAmpValues

Sets one or more color adjustment (ProcAmp) settings.
SetRate

Sets the playback rate. (IMFPMediaPlayer.SetRate)
SetRenderingPrefs

Sets various preferences related to video rendering.
SetStartStopPosition

Sets the start and stop time for the media item.
SetStreamActiveState

IEVRVideoStreamControl::SetStreamActiveState method
SetStreamOutputRect

Sets the position of a video stream within the composition rectangle.
SetStreamSelection

Selects or deselects a stream.
SetStreamSink

Sets a media sink for the media item.
SetStreamZOrder

Sets the z-order of a video stream.
SetUserData

Stores an application-defined value in the media item.
SetVideoPosition

Sets the source and destination rectangles for the video.
SetVideoProcessorMode

Sets the preferred video processor mode. The EVR will attempt to use this mode when playback starts.
SetVideoSourceRect

Sets the video source rectangle.
SetVideoWindow

Sets the clipping window for the video.
SetVolume

Sets the audio volume.
Shutdown

Shuts down the MFPlay player object and releases any resources the object is using.
Stop

Stops playback.
UpdateAlphaBitmapParameters

Updates the current alpha-blending settings, including the source and destination rectangles, the color key, and other information. You can update some or all of the blending parameters.
UpdateVideo

Updates the video frame. (IMFPMediaPlayer.UpdateVideo)

Interfaces

 
IEVRFilterConfig

Sets the number of input pins on the DirectShow Enhanced Video Renderer (EVR) filter.
IEVRFilterConfigEx

Configures the DirectShow Enhanced Video Renderer (EVR) filter.
IEVRTrustedVideoPlugin

Enables a plug-in component for the enhanced video renderer (EVR) to work with protected media.
IEVRVideoStreamControl

This interface is not supported. (IEVRVideoStreamControl)
IMFDesiredSample

Enables the presenter for the enhanced video renderer (EVR) to request a specific frame from the video mixer.
IMFPMediaItem

Represents a media item. (Deprecated.).
IMFPMediaPlayer

Contains methods to play media files. (Deprecated.).
IMFPMediaPlayerCallback

Callback interface for the IMFPMediaPlayer interface.
IMFTopologyServiceLookup

Enables a custom video mixer or video presenter to get interface pointers from the Enhanced Video Renderer (EVR).
IMFTopologyServiceLookupClient

Initializes a video mixer or presenter.
IMFVideoDeviceID

Returns the device identifier supported by a video renderer component.
IMFVideoDisplayControl

Controls how the Enhanced Video Renderer (EVR) displays video.
IMFVideoMixerBitmap

Alpha-blends a static bitmap image with the video displayed by the Enhanced Video Renderer (EVR).
IMFVideoMixerControl

Controls how the Enhanced Video Renderer (EVR) mixes video substreams.
IMFVideoMixerControl2

Controls preferences for video deinterlacing.
IMFVideoPositionMapper

Maps a position on an input video stream to the corresponding position on an output video stream.
IMFVideoPresenter

Represents a video presenter. A video presenter is an object that receives video frames, typically from a video mixer, and presents them in some way, typically by rendering them to the display.
IMFVideoProcessor

Controls video processing in the Enhanced Video Renderer (EVR).
IMFVideoRenderer

Sets a new mixer or presenter for the Enhanced Video Renderer (EVR).

Structures

 
MFP_ACQUIRE_USER_CREDENTIAL_EVENT

Event structure for the MFP_EVENT_TYPE_ACQUIRE_USER_CREDENTIAL event.
MFP_ERROR_EVENT

Event structure for the MFP_EVENT_TYPE_ERROR event.
MFP_EVENT_HEADER

Contains information that is common to every type of MFPlay event.
MFP_FRAME_STEP_EVENT

Event structure for the MFP_EVENT_TYPE_FRAME_STEP event.
MFP_MEDIAITEM_CLEARED_EVENT

Event structure for the MFP_EVENT_TYPE_MEDIAITEM_CLEARED event.
MFP_MEDIAITEM_CREATED_EVENT

Event structure for the MFP_EVENT_TYPE_MEDIAITEM_CREATED event.
MFP_MEDIAITEM_SET_EVENT

Event structure for the MFP_EVENT_TYPE_MEDIAITEM_SET event.
MFP_MF_EVENT

Event structure for the MFP_EVENT_TYPE_MF event.
MFP_PAUSE_EVENT

Event structure for the MFP_EVENT_TYPE_PAUSE event.
MFP_PLAY_EVENT

Event structure for the MFP_EVENT_TYPE_PLAY event.
MFP_PLAYBACK_ENDED_EVENT

Event structure for the MFP_EVENT_TYPE_PLAYBACK_ENDED event.
MFP_POSITION_SET_EVENT

Event structure for the MFP_EVENT_TYPE_POSITION_SET event.
MFP_RATE_SET_EVENT

Event structure for the MFP_EVENT_TYPE_RATE_SET event.
MFP_STOP_EVENT

Event structure for the MFP_EVENT_TYPE_STOP event.
MFVideoAlphaBitmap

Specifies a bitmap for the enhanced video renderer (EVR) to alpha-blend with the video.
MFVideoAlphaBitmapParams

Specifies how the enhanced video renderer (EVR) alpha-blends a bitmap with the video.
MFVideoNormalizedRect

The MFVideoNormalizedRect (evr.h) structure defines a normalized rectangle, which is used to specify sub-rectangles in a video rectangle.