saiAsrSetNBestListLength

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

Prototype

DWORD saiAsrSetNBestListLength ( SAI_RECOGNIZER_HANDLE recogHd, DWORD value )

Argument

Description

recogHd

Handle associated with a recognizer resource.

value

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

Occasionally when the recognizer matches an incoming stream with the specified grammar, the recognizer finds more than one match due to the word confidence levels or conversation paths. saiAsrSetNBestListLength sets the number of alternate results the recognizer returns in the SAIEVN_ASR_RECOGNITION_DONE event buffer.

See also

saiAsrGetNBestListLength