IAPCSpeech::Speak

This method speaks the null-terminated string stored in pszSpeak using text-to-speech (TTS).

Syntax

HRESULT IAPCSpeech::Speak( WCHAR* pszSpeak, DWORD dwID );

Parameters

pszSpeak

Pointer to the null-terminated string that contains the text to be spoken. The length of the string must be less than 2 kilobytes (KB). Strings longer than 2 KB cause unexpected speech behavior.

wID

Unsigned 16-bit integer that contains the bookmark identifier. This parameter is ignored if it is 0.

Return Values

An appropriate HRESULT value is returned.

Remarks

If the parameter is NULL, speech output is stopped.

This method always uses the default speak context, which is 0.