ISpPhoneConverter::IdToPhone

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpPhoneConverter::IdToPhone

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

The English and Chinese phoneme character sets require the phonemes to be space separated. The Japanese phoneme set requires the phoneme character form to be continuous. See the individual entries for more details about the character sets.

HRESULT IdToPhone(
   const SPPHONEID  *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.