HRESULT Find(PTTSMODEINFO pttsInfo, PTTSMODEINFORANK pttsInfoRank,
PTTSMODEINFO pttsInfoFound);
Finds the text-to-speech mode that most closely matches the desired characteristics.
· Returns NOERROR if successful, or one of these error values:
<E_FAIL>
<E_INVALIDARG>
<E_OUTOFMEMORY>
<TTSERR_INVALIDMODE>
pttsInfo
[in] Address of a TTSMODEINFO structure that contains the desired characteristics.
pttsInfoRank
[in] Address of a TTSMODEINFORANK structure that contains the relative importance of each characteristic. If this parameter is NULL, the object uses the default ranking provided by the engine.
pttsInfoFound
[out] Address of a TTSMODEINFO structure that receives information about the text-to-speech mode that was found. It is valid only if an error value is not returned.
If no engines can be found or the system runs out of memory, an error is returned.