Displaying Modal User Interfaces

  • Article

[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.]

UI plug-ins should not display modal dialog boxes or message boxes in response to method calls from Windows Media Player. For example, do not display a message box from your implementation of IWMPPluginUI::Create.

If you must display a dialog box or message box from a UI plug-in method implementation that is called by the Player, you must follow these steps:

  1. Register a new window message using RegisterWindowMessage.
  2. Send the window message you registered to your UI plug-in window using PostMessage.
  3. Show the dialog box or message box from the message handler for your new window message.

UI Plug-in Overview