saiAsrGetNBestListLength

Retrieves the maximum number of alternative results the recognizer can return for matches above the confidence threshold.

Prototype

DWORD saiAsrGetNBestListLength ( SAI_RECOGNIZER_HANDLE recogHd, DWORD *value )

Argument

Description

recogHd

Handle associated with a recognizer resource.

value

Pointer to the number of results to return.


Return values

Return value

Description

SUCCESS

 

SAIERR_INVALID_PARAMETER

One of the specified arguments is invalid.

SAIERR_UNSUPPORTED_SPEECH_PARAMETER

Recognizer engine does not support the specified parameter.


Details

When the recognizer matches an incoming stream with the specified grammar, it sometimes finds more than one match due to the word confidence levels or conversation paths. The best-list-length parameter sets the number of alternate results the recognizer returns in the SAIEVN_ASR_RECOGNITION_DONE event buffer.

See also

saiAsrGetConfidenceThreshold, saiAsrSetNBestListLength