Microsoft Speech SDK SAPI 5.1

---

SPDUI_AudioProperties (C/C++)

SpeechAudioProperties (Automation)

SPDUI_AudioProperties defines the string for displaying an audio object's properties user interface (UI).

#define SPDUI_AudioProperties        L"AudioProperties"

When to Implement

An application can modify the object's implementation-specific properties for a custom audio object. For example, the SAPI implementation of the multimedia audio object has a UI so that the user can select the multimedia device line (e.g., microphone input, line input, etc.).

A custom audio object that performed noise reduction on the input stream could have a UI for selecting the audio input object to read data from initially. It could also display a UI that allows the user to adjust how much noise reduction is performed.

Speech properties in Control Panel allows the user to select the default audio input and output objects. Click 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), 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