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.