IWMPEffects2::OnWindowMessage method (effects.h)

Article
4/26/2023

[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 OnWindowMessage method is called by Windows Media Player to pass window messages to a visualization.

Syntax

HRESULT OnWindowMessage(
  [in] UINT    msg,
  [in] WPARAM  WParam,
  [in] LPARAM  LParam,
  [in] LRESULT *plResultParam
);

Parameters

[in] msg

UINT that identifies the window message.

[in] WParam

WPARAM specifying a window message parameter.

[in] LParam

LPARAM specifying a window message parameter.

[in] plResultParam

Pointer to an LRESULT specifying the result code for the window message.

Return value

This method returns an HRESULT.

Remarks

Your implementation must only return S_OK if it has handled the window message. If it has not handled the window message, it should return S_FALSE. If this method is not implemented, return E_NOTIMPL.

Requirements


Minimum supported client	Windows Media Player 9 Series or later.
Target Platform	Windows
Header	effects.h