Microsoft Speech Platform
ISpPhoneticAlphabetConverter::SAPI2UPS
Returns the UPS phone id of the specified SAPI phone.
HRESULT SAPI2UPS(
SPPHONEID *pszSAPIId
SPPHONEID *pszUPSId
DWORD cMaxLength
);
Parameters
- pszSAPIId
- [in] The SAPI phone to be converted.
- pszUPSId
- [out] The UPS phone that was converted from SAPI.
- cMaxLength
- The length, in phonemes, of the caller-provided buffer pszUPSId, including the terminating null phoneme ID. Applications can supply a buffer size of SP_MAX_PRON_LENGTH + 1, or they can obtain the required size of the output buffer by calling GetMaxConvertLength.
Return values
| Value | Description |
|---|---|
| SPERR_BUFFER_TOO_SMALL | The specified output buffer length is not sufficient. |
| SPERR_PHONEME_CONVERSION | The input phoneme string cannot be converted to the desired alphabet. This typically means the phoneme IDs are invalid for the current language. |
| S_OK | Function completed successfully. |