IAgentAudioOutputPropertiesEx::GetStatus

[Microsoft Agent は Windows 7 の時点で非推奨となり、後続のバージョンの 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 を使用)。