IWMPEffects2::RenderWindowed method (effects.h)
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The RenderWindowed method is called by Windows Media Player to render a windowed visualization.
Syntax
HRESULT RenderWindowed(
[in] TimedLevel *pData,
[in] BOOL fRequiredRender
);
Parameters
[in] pData
Pointer to a TimedLevel structure specifying rendering information.
[in] fRequiredRender
BOOL indicating whether the visualization must paint itself.
Return value
This method returns an HRESULT.
Remarks
This method is used to render windowed visualizations. Windowless visualizations should return S_OK and use the IWMPEffects::Render method instead.
The fRequiredRender parameter informs you that your visualization must repaint itself, for example, when another window is dragged over it. When this value is false, you can safely skip over the rendering code if the current media item is stopped or paused. This lets you avoid consuming CPU cycles unnecessarily.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Media Player 9 Series or later. |
| Target Platform | Windows |
| Header | effects.h |