ISpRecognizerLite::ReTrain
This method prompts the user to re-enter a speech sample. This is logically equivalent to calling the Delete and then Train methods, however it may allow the engine to utilize implementation efficiencies.
HRESULT ReTrain (
SPRECOGNITIONMETHOD eRM,
SPTYPEHEADER* psth,
IUnknown* pUnk
);
Parameters
eRM
[in] Identifies which recognition method should be used.psth
[out][in] Pointer to information that identifies the pattern.Recognition method SPTYPEHEADER type SPRM_CONTINUOUSDIGIT SPT_NULL. This is ignored. SPRM_VOICETAG SPT_DWORD pUnk
[in] Pointer to a client callback interface. This parameter is currently NULL and ignored.
Return Values
| Value | Description |
|---|---|
| S_OK | Success |
| E_NOTIMPL | Not implemented. |
| SP_INSUFFICIENT_DATA | A sample was successfully obtained, however the recognition needs to be performed again; that is, the client should call the Train method again. |
Otherwise, it returns an appropriate failure code from the return code list.
Remarks
The engine should not provide any training or delete UI unless it is required and noted in the SPPT_CUSTOMUI property. Should the engine require another training sample, it should return SP_INSUFFICIENT_DATA and return to the client. At that point, the client can update its UI and call the ReTrain or Train methods again.
Requirements
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: itspeech.h
See Also
Send Feedback on this topic to the authors