IMessenger::MediaWizard Method

  • Article

Deprecated. Launches the Audio and Video Tuning Wizard dialog box.

Syntax

HRESULT MediaWizard(      
    long hwndParent
);

Parameters

  • hwndParent
    [in] A LONG. Reserved. All current implementations or calls should set this parameter to 0 or NULL.

Return Value

For a table of MSGR_E_* constants, see MSGRConstants.

Returns one of the following values:

S_OK Success.

- or -

The client is offline.
MSGR_E_CONTACT_UI_ACTIVE Called this method while the Add a Contact or Find a Contact dialog box was enabled and visible.
MSGR_E_LOGON_UI_ACTIVE Called this method while the Sign In dialog box was enabled and visible.
MSGR_E_OPTION_UI_ACTIVE Called this method while the Options dialog box was enabled and visible.
MSGR_E_OTHER_UI_ACTIVE Called this method while the Customer Experience Improvement Program(CEIP) dialog box was enabled and visible.
E_FAIL Could not create the dialog box or the Messenger object is not responding.

Remarks

Only one Audio and Video Tuning Wizard dialog box can be active at one time. Calling IMessenger::MediaWizard multiple times returns S_OK.

Calling IMessenger::MediaWizard while the client is offline will display the dialog box with S_OK as HResult. This is identical to the behavior that results if a client user selects the Audio and Video Tuning Wizard menu option while offline.

If audio levels have not been set previously on the client, calling IMessenger::StartVoice will display the Audio and Video Tuning Wizard. Without properly tuned levels, voice communication is difficult or impossible.

Important  IMessenger::MediaWizard is no longer available in Windows Vista. See Windows Messenger for more information.

Note  This method is available for scripting languages.