ISpRecognizerLite::ReTrain

Send Feedback

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

ISpRecognizerLite

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.