Microsoft DirectX 8.1 (C++)

IFullScreenVideo::IsModeAvailable

The IsModeAvailable method determines if a specified video mode is available.

Syntax

HRESULT IsModeAvailable(
  long Mode
);

Parameters

Mode

[in] Full-screen mode to check.

Return Value

Returns S_OK if the video mode is available or S_FALSE if it isn't.

Remarks

The display modes supported by the Full Screen Renderer are different than the actual modes available on any given display card. The application should call this method only when the renderer is connected, because until then the renderer might not have allocated the resources it needs to make this information available. Even if a 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.

See Also