Share via

IAgentAudioOutputPropertiesEx::GetStatus

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

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

오디오 채널의 상태 검색합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다.

plStatus

다음 값 중 하나일 수 있는 오디오 출력 채널의 상태입니다.

값 Description
const unsigned shortAUDIO_STATUS_AVAILABLE = 0;
 오디오 출력 채널을 사용할 수 있습니다(사용 중이 아님).
const unsigned shortAUDIO_STATUS_NOAUDIO = 1;
 오디오 출력은 지원되지 않습니다. 예를 들어 소리 카드 없기 때문입니다.
const unsigned shortAUDIO_STATUS_CANTOPENAUDIO = 2;
 오디오 출력 채널을 열 수 없습니다(사용 중임). 예를 들어 다른 애플리케이션이 오디오를 재생하고 있기 때문입니다.
const unsigned shortAUDIO_STATUS_USERSPEAKING = 3;
 서버가 사용자 음성 입력을 처리하고 있으므로 오디오 출력 채널이 사용 중입니다.
const unsigned shortAUDIO_STATUS_CHARACTERSPEAKING = 4;
 문자가 현재 말하고 있기 때문에 오디오 출력 채널이 사용 중입니다.
const unsigned shortAUDIO_STATUS_SROVERRIDEABLE = 5;
 오디오 출력 채널이 사용 중이 아니지만 사용자 음성 입력을 기다리고 있습니다.
const unsigned shortAUDIO_STATUS_ERROR = 6;
 오디오 출력 채널에 액세스하려고 할 때 다른(알 수 없는) 문제가 있었습니다.

이 설정을 사용하면 클라이언트 애플리케이션이 오디오 출력 채널의 상태를 쿼리할 수 있습니다. 이를 사용하여 문자가 말하도록 할지 또는 수신 모드를 켜려고 할지 결정할 수 있습니다( IAgentCharacterEx::Listen 사용).