IAgentNotifySinkEx::ListeningState

[自 Windows 7 起弃用 Microsoft Agent，在后续版本的 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	侦听模式已关闭，因为用户已禁用语音输入。

当用户按下“侦听”键后或超时结束时，再或是活动输入客户端使用 True 或 False 调用了 IAgentCharacterEx::Listen 方法时，均会在侦听模式启动时将此事件发送到所有客户端。

该事件会将该值返回到当前已加载此字符的客户端。所有其他客户端均会收到空字符（空字符串）。

另请参阅