SPDUI_AudioProperties (Windows Embedded CE 6.0)
1/6/2010
This variable defines the string for displaying an audio object's properties UI.
#define SPDUI_AudioProperties L"AudioProperties"
When to Implement
When writing a custom audio object, an application can modify the object's implementation specific properties. For example, the SAPI implementation of the multimedia audio object has a UI to allow the user to select the multimedia device line (for example, microphone input, line input, and so on).
A custom audio object that performed noise reduction on the input stream could have UI for selecting the audio input object to read data from initially. It could also display UI that allows the user to adjust how much noise reduction is performed.
The Speech Control Panel allows the user to select the default audio input and output objects. Choose Properties to directly access each audio object's properties UI using SPDUI_AudioProperties. If the audio object does not support the Properties UI (see ISpTokenUI::IsUISupported), then Properties will be unavailable.
Example
The following code snippet illustrates the use of ISpTokenUI::IsUISupported using SPDUI_AudioProperties.
HRESULT hr = S_OK;
// get the default input audio object token
hr = SpGetDefaultTokenFromCategoryId(SPCAT_AUDIOIN, &cpObjectToken);
// Check hr
// get the object token's UI
hr = cpObjectToken->QueryInterface(&cpTokenUI);
// Check hr
// check if the default audio input object has UI for Properties
hr = cpTokenUI->IsUISupported(SPDUI_AudioProperties, NULL, NULL, NULL, &fSupported);
// Check hr
// if fSupported == TRUE, then default audio input object has UI for Properties