Forcibly stops voice recognition processing by the Voice Recognition System

Syntax

#include <ultra64.h> /* ultra64.h */

s32 osVoiceStopReadData(OSVoiceHandle *hd);

Description

The osVoiceStopReadData function is for forcibly stopping recognition processing once recognition by the Voice Recognition System has been started.

hd is the Voice Recognition System control structure. The Voice Recognition System must be initialized with the osVoiceInit function before the osVoiceStopReadData function is called.

The returned value is an error code. A 0 (zero) is returned when processing ends normally. If an error occurs, this function has the following error codes.

CONT_ERR_NO_CONTROLLER

Nothing is connected to the controller port.

CONT_ERR_DEVICE

Something other than the Voice Recognition System is connected to the controller port.

CONT_ERR_VOICE_NO_RESPONSE

There was no response from the Voice Recognition System. There may be a problem with the hardware.

(Note)This error was reported to have occurred once in a while even with normal hardware. Therefore, be sure to start over again with initializing the voice recognition system when this error occurs.

CONT_ERR_CONTRFAIL

There was a data transmission failure. There is a problem in the Voice Recognition System connection.

CONT_ERR_INVALID

There is an error in the function call method or in the argument. This error will not occur if the function is being used correctly.

See also

osVoiceCheckWord, osVoiceClearDictionary, osVoiceControlGain, osVoiceCountSyllables, osVoiceGetReadData, osVoiceInit, osVoiceMaskDictionary, osVoiceSetWord, and osVoiceStartReadData

Revision History

1999/04/30 Changed Format
1999/08/04 Added (Note) to CONT_ERR_VOICE_NO_RESPONSE