Поделиться через

IAgentNotifySinkEx::ListeningState

  • Статья

[Microsoft Agent не рекомендуется использовать в Windows 7 и может быть недоступно в последующих версиях Windows.]

HRESULT ListeningState(
   long dwCharacterID,  // character ID
   long bListening,     // listening mode state
   long dwCause         // cause  
);

Уведомляет клиентское приложение при изменении режима прослушивания.

  • Нет возвращаемого значения.

dwCharacterID

Символ, для которого изменилось состояние прослушивания.

bListening

Состояние режима прослушивания. Значение True указывает, что запущен режим прослушивания; False, что режим прослушивания закончился.

dwCause

Причина события, которая может быть одним из следующих значений.

значение Описание
const unsigned long LSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;
 Режим прослушивания отключен кодом программы.
const unsigned long LSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;
 Время ожидания режима прослушивания (включено по коду программы).
const unsigned long LSCOMPLETE_CAUSE_USERTIMEDOUT = 3;
 Время ожидания режима прослушивания (включенное ключом прослушивания).
const unsigned long LSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;
 Режим прослушивания отключен, так как пользователь выпустил ключ прослушивания.
const unsigned long LSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;
 Режим прослушивания отключен, так как пользователь закончил говорить.
const unsigned long LSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;
 Режим прослушивания отключен, так как входной активный клиент был деактивирован.
const unsigned long LSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7
 Режим прослушивания отключен, так как символ по умолчанию был изменен.
const unsigned long LSCOMPLETE_CAUSE_USERDISABLED = 8
 Режим прослушивания отключен, так как пользователь отключил входные данные речи.

Это событие отправляется всем клиентам, когда режим прослушивания начинается после нажатия клавиши прослушивания или окончания времени ожидания или при завершении ввода-активного клиента вызывает метод IAgentCharacterEx::Listen с значением True или False.

Событие возвращает значения клиентам, которые в настоящее время загружают этот символ. Все остальные клиенты получают пустой символ (пустую строку).

См. также

IAgentCharacterEx::Listen