Invoke a Tuning Wizard

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The Tuning Wizard is a user interface that allows you to select a preferred audio or video device and to specify the capture and render volume of audio devices and video characteristics of video devices. If a vendor-supplied device tuning page exists for the selected media type, the Tuning Wizard calls that page. The values you set using the Tuning Wizard are also available through the IUccPropertyCollection interface returned by a call to GetDeviceSettings on the IUccMediaDeviceSettings interface of a media device manager object.

The media device manager remains in auto-select mode for a device type until the Tuning Wizard runs and an alternate device is manually selected. The device manager remains in manual-select mode until the device is unplugged.

Tuning Wizard Pages

The Tuning Wizard is invoked by specifying the HWND value of the Windows Form containing the code and a specific Tuning Wizard page. There are Tuning Wizard pages for audio, video, speaker, microphone, and introduction. To specify the Tuning Wizard pages to display, supply the UCC_TUNING_WIZARD_PAGE enumeration values.

For example, if you want to set the capture and render volumes of the non-private audio devices, the private audio devices, and the webcam, you supply the enumeration sum: UCC_TUNING_WIZARD_PAGE. UCC_TUNING_WIZARD_PAGE.UCCTWP_AUDIO_NONPRIVATE + UCC_TUNING_WIZARD_PAGE.UCCTWP_AUDIO +UCC_TUNING_WIZARD_PAGE.UCCTWP_WEBCAM as the Tuning Wizard page argument. This allows you to set the capture and render volumes for the microphone and speaker. Non-private audio is usually captured by your webcam microphone. Non-private rendered audio is usually your speakerphone speaker.

Example

The following code snippet illustrates calling the audio non-private Tuning Wizard page. ds is an object implementing the IUccMediaDeviceSettings interface.

private int wizardPage = (int)UCC_TUNING_WIZARD_PAGE.UCCTWP_AUDIO + 
                             (int)UCC_TUNING_WIZARD_PAGE.UCCTWP_AUDIO_NONPRIVATE + 
                         (int)UCC_TUNING_WIZARD_PAGE.UCCTWP_WEBCAM;
ds.InvokeTuningWizard(this.Handle.ToInt32(), wizardPage);

See Also

Concepts

Get a Collection of Media Devices
Get and Set the Selected Device for a Media Type