ISRAttributes::ThresholdGet

HRESULT ThresholdGet(DWORD *pdwThreshold);

Retrieves the threshold level of the speech-recognition engine. The threshold level indicates how confident the speech-recognition engine must be about the validity of a given recognition in order to accept it. If the engine is not confident enough, it notifies the application that the phrase was not recognized.

· Returns NOERROR if successful, or one of these error values:

E_INVALIDARG
E_OUTOFMEMORY
SRERR_NOTSUPPORTED
SRERR_VALUEOUTOFRANGE

pdwThreshold

[out] Address of a variable that receives the threshold.

The threshold level is a value from 0 to 100 that indicates the threshold below which an utterance is rejected as unrecognized. A value of 0 indicates that the engine matches any utterance to the closest phrase match. A value of 100 indicates that the engine must be absolutely certain that an utterance is the recognized phrase. The optimum threshold for the average user should be 50.