Partager via

IMixerOCX interface (mixerocx.h)

  • Article

[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 IMixerOCX interface is implemented on the Overlay Mixer. This interface enables clients that do not own their own windows, such as an ActiveX control, to set properties of the video rectangle and advise the filter of events.

Note  Applications should generally use the Video Mixing Renderer Filter 9 (VMR-9) and not the Overlay Mixer. The only scenario that requires the Overlay Mixer is when the video capture or decoder hardware uses video ports to transfer video data to the graphics card. The VMR-9 does not support video ports.
 

Inheritance

The IMixerOCX interface inherits from the IUnknown interface. IMixerOCX also has these types of members:

Methods

The IMixerOCX interface has these methods.

 
IMixerOCX::Advise

The Advise method provides the Overlay Mixer with a pointer to the client's IMixerOCXNotify interface for callback notifications.
IMixerOCX::GetAspectRatio

The GetAspectRatio method returns the current aspect ratio setting on the Overlay Mixer. (Currently not implemented.).
IMixerOCX::GetStatus

The GetStatus method returns the current status of the Overlay Mixer. (Not implemented.).
IMixerOCX::GetVideoSize

The GetVideoSize method retrieves the current size of the video rectangle.
IMixerOCX::OnDisplayChange

The OnDisplayChange method informs the Overlay Mixer that the monitor's display settings have changed. (Not implemented.).
IMixerOCX::OnDraw

The OnDraw method instructs the Overlay Mixer to draw the video rectangle.
IMixerOCX::SetDrawRegion

The SetDrawRegion method specifies the location and dimensions of the video and clipping rectangles in screen coordinates.
IMixerOCX::UnAdvise

The UnAdvise method instructs the Overlay Mixer to release its pointer to the client's IMixerOCXNotify interface.

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 mixerocx.h