ITTSDialogs::GeneralDlg

HRESULT GeneralDlg(HWND hWndParent, PWSTR pszTitle);

Displays a General dialog box that gives the user general control of the text-to-speech engine and gives the user full access to engine-specific controls.

· Returns NOERROR if successful, or one of these error values:

<E_INVALIDARG>
<E_OUTOFMEMORY>
<TTSERR_INVALIDWINDOW>
<TTSERR_NOTSUPPORTED>
<TTSERR_VALUEOUTOFRANGE>

hWndParent

[in] Handle of the parent window. If this parameter is NULL, the engine returns NOERROR if it supports the General dialog box or TTSERR_NOTSUPPORTED if it does not.

pszTitle

[in] Address of the string to use as the title of the dialog box. This parameter can be NULL to direct the engine to provide a default title.

Depending on the engine, GeneralDlg may allow the user to perform these tasks:

· Set the maximum amount of disk space allotted for text-to-speech. This is relevant for playing concatenated wave files.

· Set the speaker preferences supported by the engine.

· Access all of the standard dialog boxes.