Microsoft Speech SDK
SAPI 5.1
ISpVoice::Speak
ISpVoice::Speak speaks the contents of a text string or file.
HRESULT Speak(
const WCHAR *pwcs,
DWORD dwFlags,
ULONG *pulStreamNumber
);
Parameters
- pwcs
- [in, string] Pointer to the null-terminated text string (possibly containing XML markup) to be synthesized. This value can be NULL when dwFlags is set to SPF_PURGEBEFORESPEAK indicating that any remaining data to be synthesized should be discarded. If dwFlags is set to SPF_IS_FILENAME, this value should point to a null-terminated, fully qualified path to a file.
- dwFlags
- [in] Flags used to control the rendering process for this call. The flag values are contained in the SPEAKFLAGS enumeration.
- pulStreamNumber
- [out] Pointer to a ULONG which receives the current input stream number associated with this Speak request. Each time a string is spoken, an associated stream number is returned. Events queued back to the application related to this string will contain this number. If NULL, no value is passed back.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_INVALIDARG | One or more parameters are invalid. |
| E_POINTER | Invalid pointer. |
| E_OUTOFMEMORY | Exceeded available memory. |
| SPERR_INVALID_FLAGS | Invalid flags specified for this operation. |
| SPERR_DEVICE_BUSY | Timeout occurred on synchronous call. |