IVCmdNotifySink::CommandOther

This method notifies the application that the engine did not recognize a spoken phrase, or recognized it as being from another application’s command set.

Syntax

HRESULT CommandOther( PVCMDNAME pName, PTSTR pszCommand);

Parameters

pName

[in] Pointer to a VCMDNAME structure that contains the name of the voice menu that has the recognized command. If this parameter contains NULL, the command was not recognized.

pszCommand

[in] Pointer to the null-terminated string for the command. If this parameter contains NULL, the command was not recognized.

Return Values

The return value is ignored.

Remarks

Along with the notification method, the application receives the address of the phrase.

An application can use this notification to monitor utterances and inform the user what was heard. An application should not rely on this notification for information about the recognition of its own commands. Most applications ignore this notification.

The command string contains the words actually spoken by the user. If the command contains a list name, the command string may not match the words of the command. For example, the string pointed to by pszCommand might be “Send mail to Fred,” whereas the command string is “Send mail to name.”

The notification is sent only to applications that, when registered to use voice commands on the site, did one of the following:

• Set the dwFlags parameter of the IVoiceCmd::Register method to the VCMDRF_ALLBUTVUMETER value.
• Set the VCMDRF_CMDOTHER bit.

If two or more voice menus contain the same phrase and this phrase is recognized, it is indeterminate which of the menus causes the engine to call the IVCmdNotifySink::CommandRecognize notification and which causes it to call CommandOther. This happens only if the menus are all global or all window-specific.