IAgentAudioOutputPropertiesEx::GetStatus

[自 Windows 7 起弃用 Microsoft Agent，在后续版本的 Windows 中可能不可用。]

HRESULT GetStatus(
   long * plStatus,  // address of audio channel status
);

检索音频通道的状态。

• 返回 S_OK 表示操作成功。

plStatus

音频输出通道的状态，可以是以下值之一：

值	说明
const unsigned short AUDIO_STATUS_AVAILABLE = 0;	音频输出通道可用（不繁忙）。
const unsigned short AUDIO_STATUS_NOAUDIO = 1;	不支持音频输出；例如，因为没有声卡。
const unsigned short AUDIO_STATUS_CANTOPENAUDIO = 2;	无法打开音频输出通道（正忙）：例如，因为另一个应用程序正在播放音频。
const unsigned short AUDIO_STATUS_USERSPEAKING = 3;	音频输出通道繁忙，因为服务器正在处理用户语音输入
const unsigned short AUDIO_STATUS_CHARACTERSPEAKING = 4;	音频输出通道正忙，因为当前有角色正在说话。
const unsigned short AUDIO_STATUS_SROVERRIDEABLE = 5;	音频输出通道不繁忙，但它正在等待用户语音输入。
const unsigned short AUDIO_STATUS_ERROR = 6;	尝试访问音频输出通道时出现了一些其他（未知）问题。

此设置可让客户端应用程序查询音频输出通道的状态。 您可以使用它来确定让角色说话还是尝试打开聆听模式（使用 IAgentCharacterEx::Listen）。