ISpPhoneConverter::IdToPhone (Microsoft Speech Platform)

Microsoft Speech Platform SDK 11

Microsoft Speech Platform

ISpPhoneConverter::IdToPhone

ISpPhoneConverter::IdToPhone converts a null-terminated ID code array to the SAPI character format.

The English and Chinese phoneme character sets require that each phoneme be separated/delimited from the next phoneme by a space. The Japanese phoneme character set requires the phoneme characters to be continuous, with no delimiters. See the individual English, Chinese, and Japanese topics for more details about their character sets.

HRESULT IdToPhone(
   const PCSPPHONEID    *pId,
   WCHAR                *pszPhone
);

Parameters

pId
[in] Address of the null-terminated array of SPPHONEIDs that contains the phoneme identifiers.
pszPhone
[out] Address of a null-terminated string that receives the phoneme string information.

Return values

Value Description
S_OK Function completed successfully.
E_INVALIDARG One or more parameters are invalid. Alternatively, pId exceeds SP_MAX_PRON_LENGTH.
E_POINTER pszPhone or pId is invalid or bad.
SPERR_UNINITIALIZED Interface not initialized.
E_FAIL Member exceeds available size.
FAILED(hr) Appropriate error message.