IFullScreenVideoEx::IsModeAvailable
| Microsoft DirectShow 9.0 |
IFullScreenVideoEx::IsModeAvailable
The IsModeAvailable method queries whether a specified display mode is available.
Syntax
HRESULT IsModeAvailable( long Mode );
Parameters
Mode
[in] Index of the display mode.
Return Values
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| E_INVALIDARG | Index out of range. |
| S_FALSE | The display mode is not available. |
| S_OK | The display mode is available. |
Remarks
The Full Screen Renderer supports a static set of display modes. However, the video card on the user's system might not support every mode. If a particular display mode is not supported by the video card, this method returns S_FALSE. Even if a particular mode is available, it will not necessarily be used for video playback. The mode must also be compatible with the filters in the filter graph.
You can disable a display mode by calling the IFullScreenVideoEx::SetEnabled method. The Full Screen Renderer will not use a disabled mode, even if the video card supports it.
Display modes are indexed from zero. The IFullScreenVideoEx::CountModes method returns the number of modes.
Requirements
Header: Declared in Amvideo.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also