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. |