Microsoft DirectX 9.0

Video Renderer Filter

The Video Renderer filter is a robust, all-purpose video renderer.

Note   In Microsoft Windows XP, the default video renderer is the Video Mixing Renderer (VMR). The VMR and the Video Renderer both have the friendly name "Video Renderer." On all other platforms, the Video Renderer is the default renderer, although applications can use the VMR-9 for advanced rendering capabilities.

The Video Renderer uses Microsoft® DirectDraw® and overlay surfaces, if the video card supports them. The Filter Graph Manager exposes the IVideoWindow interface, which enables applications to set and retrieve properties on the Video Renderer. With newer video cards, the Video Renderer supports full-screen rendering. Otherwise, the Filter Graph Manager automatically switches to the Full Screen Renderer filter for full-screen mode. See IVideoWindow::put_FullScreenMode for more information.

Important   Normally, this filter's video window processes messages on a worker thread created by the Filter Graph Manager. Howerver, if an application directly creates the filter using CoCreateInstance, the video window processes messages on the application thread. In that case, the application thread must have a message loop, to dispatch messages to the video window. Also, the thread must not exit until the final Release call to the Video Renderer, which occurs when the Filter Graph Manager shuts down. Otherwise, the application might deadlock.

Filter Interfaces IBaseFilter, IBasicVideo, IBasicVideo2, IDirectDrawVideo, IKsPropertySet, IMediaPosition, IMediaSeeking, IQualityControl, IQualProp, IVideoWindow
Input Pin Media Types MEDIATYPE_Video
Input Pin Interfaces IMemInputPin, IOverlay, IPin, IPinConnection, IQualityControl
Output Pin Media Types Not applicable.
Output Pin Interfaces Not applicable.
Filter CLSID CLSID_VideoRenderer
Property Page CLSID No property page.
Executable quartz.dll
Merit Windows 98, Me, NT, 2000: MERIT_PREFERRED

Windows XP: MERIT_UNLIKELY

Filter Category CLSID_LegacyAmFilterCategory

Remarks

In the debug version of Quartz.dll, if the LOG_TRACE debug level is set to 5 or higher, the Video Renderer displays each frame's time stamps on the video window. These numbers do not appear in the retail version of the DLL. For more information, see Debug Output Functions.

The following remarks are intended for filter developers:

The Video Renderer accepts YUV formats if the video graphics card supports YUV overlay surfaces. When it first connects to the upstream filter, however, the Video Renderer requires an RGB format that matches the color depth of the current monitor settings. For example, if the current display setting is 24-bit color, the upstream filter must be able to provide 24-bit RGB video. When the filter graph switches to a runing state, the Video Renderer negotiates a dynamic format change to the appropriate YUV color space.

By connecting with an RGB type, the Video Renderer ensures that it can use GDI in case DirectDraw is not available. It will switch to GDI if another application is using the video memory, if the video rectangle straddles two monitors on a multi-monitor system, or if the video rectangle is completely obscured by another window.

Note   The Video Mixing Renderer does not perform this type of dynamic format change, and does not require an RGB media type, because it never uses GDI for rendering.

To negotiate a format change, the Video Renderer calls IPin::QueryAccept with the new media type. If the upstream filter returns S_OK, the Video Renderer attaches the new media to the next sample. The upstream filter should call IMediaSample::GetMediaType on each sample. If GetMediaType returns a non-NULL value, it indicates a format change, and the upstream filter should respond by switching output types. (Do not switch types in the QueryAccept method.) The upstream filter should accept at least the major RGB types, and ideally should support the common YUV types. During streaming, the Video Renderer might switch back and forth between YUV and RGB types any number of times. The Video Renderer does not accept dynamic format changes initiated by the upstream filter.

When the Video Renderer draws to a DirectDraw overlay surface, it allocates a single buffer for its input pin. If the upstream filter attempts to force a connection using multiple buffers, the Video Renderer will be unable to use the overlay surface.