IFullScreenVideoEx interface (amvideo.h)
[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 IFullScreenVideoEx interface is implemented on the Full Screen Renderer filter, which provides full-screen video rendering on older hardware. Newer video cards can stretch the video efficiently enough that the Full Screen Renderer is not required. Therefore, both the filter and this interface are now deprecated.
Inheritance
The IFullScreenVideoEx interface inherits from the IUnknown interface. IFullScreenVideoEx also has these types of members:
Methods
The IFullScreenVideoEx interface has these methods.
| IFullScreenVideoEx::CountModes The CountModes method retrieves the number of display modes that the Full Screen Renderer supports. |
| IFullScreenVideoEx::GetAcceleratorTable The GetAcceleratorTable method retrieves the accelerator table currently being used to translate keyboard messages. The Full Screen Renderer filter does not support this method. |
| IFullScreenVideoEx::GetCaption The GetCaption method retrieves the caption associated with the full-screen window. |
| IFullScreenVideoEx::GetClipFactor The GetClipFactor method retrieves the clip factor, which determines how much of the video the Full Screen Renderer is allowed to clip. For example, if the clip factor is 25, the Full Screen Renderer can clip up to 25% of the video. |
| IFullScreenVideoEx::GetCurrentMode The GetCurrentMode method retrieves the current display mode. |
| IFullScreenVideoEx::GetMessageDrain The GetMessageDrain method retrieves the window that receives mouse and keyboard messages, if any. |
| IFullScreenVideoEx::GetModeInfo The GetModeInfo method retrieves information about a specified display mode supported by the Full Screen Renderer filter. |
| IFullScreenVideoEx::GetMonitor The GetMonitor method queries which monitor the Full Screen Renderer is using. The Full Screen Renderer only supports the primary monitor, so the returned value is always zero. |
| IFullScreenVideoEx::HideOnDeactivate The HideOnDeactivate method . Depending on the setting, the full-screen video window is either minimized or hidden. If it is minimized, it appears as an icon in the task bar; otherwise, it does not. |
| IFullScreenVideoEx::IsHideOnDeactivate The IsHideOnDeactivate method indicates the behavior when the user switches to another application. |
| IFullScreenVideoEx::IsKeepPixelAspectRatio The IsKeepPixelAspectRatio method queries whether the pixel aspect ratio is maintained. The Full Screen Renderer filter does not support this method; it always maintains the pixel aspect ratio. |
| IFullScreenVideoEx::IsModeAvailable The IsModeAvailable method queries whether a specified display mode is available. |
| IFullScreenVideoEx::IsModeEnabled The IsModeEnabled method queries whether a specified display mode is enabled. |
| IFullScreenVideoEx::KeepPixelAspectRatio The KeepPixelAspectRatio method specifies whether to maintain the pixel aspect ratio. The Full Screen Renderer filter does not support this method; it always maintains the pixel aspect ratio. |
| IFullScreenVideoEx::SetAcceleratorTable The SetAcceleratorTable method specifies an accelerator table that will be used to translate keyboard messages. The Full Screen Renderer filter does not support this method. |
| IFullScreenVideoEx::SetCaption The SetCaption method sets the caption associated with the full-screen window. |
| IFullScreenVideoEx::SetClipFactor The SetClipFactor method specifies the clip factor, which determines how much of the video the Full Screen Renderer is allowed to clip. |
| IFullScreenVideoEx::SetDefault The SetDefault method saves the current settings. |
| IFullScreenVideoEx::SetEnabled The SetEnabled method enables or disables a specified display mode. |
| IFullScreenVideoEx::SetMessageDrain The SetMessageDrain method specifies a window to receive mouse and keyboard messages from the video window. |
| IFullScreenVideoEx::SetMonitor The SetMonitor method specifies which monitor to use. The Full Screen Renderer only supports the primary monitor, however, so this method is not useful in the current implementation. |
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 | amvideo.h (include Dshow.h) |