IVideoWindow::put_FullScreenMode method (control.h)
put_FullScreenMode method enables or disables full-screen video rendering.
HRESULT put_FullScreenMode( [in] long FullScreenMode );
Boolean value that specifies whether to enable or disable full-screen mode. Must be one of the following values:
|OATRUE||Switch to full-screen mode.|
|OAFALSE||Disable full-screen mode. (Default.)|
Possible return values include the following:
||Filter does not support full-screen mode.|
||Already in the requested mode.|
||Could not find any filter that supports full-screen mode.|
Depending on the video renderer, the switch to full-screen mode may not be visible until the application runs or pauses the graph. In full-screen mode, if the user switches away from the application (for example, using ALT + TAB), the Filter Graph Manager sends an EC_FULLSCREEN_LOST event.
The following remarks describe how the Filter Graph Manager implements full-screen mode. Application developers can probably ignore this information, but it may be useful if you are writing a custom video renderer.
When an application switches to full-screen mode, the Filter Graph Manager searches for a video renderer that will function most efficiently. In order of preference, these are:
- Any video renderer in the filter graph that natively supports full-screen mode.
- Any video renderer in the filter graph that can stretch the video to full-screen without a significant performance cost.
- The Full Screen Renderer filter.
- Any video renderer in the filter graph that supports IVideoWindow.
For the second option, the Filter Graph Manager calls IVideoWindow::GetMaxIdealImageSize and GetMinIdealImageSize on every video renderer in the graph. If the size of the display falls within the filter's reported range, it indicates that the filter can stretch the video without a significant performance cost.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||control.h (include Dshow.h)|