IAgentCharacterEx::GetSRStatus

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

HRESULT GetSRStatus(
   long * plStatus  // address of the speech input status
);

음성 입력을 지원하는 데 필요한 조건의 상태 검색합니다.

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

plStatus

상태 설정에 대해 다음 값 중 하나를 수신하는 변수의 주소입니다.

값	Description
const unsigned longLISTEN_STATUS_CANLISTEN = 0;	조건은 음성 입력을 지원합니다.
const unsigned longLISTEN_STATUS_NOAUDIO = 1;	이 시스템에서 사용할 수 있는 오디오 입력 디바이스가 없습니다. (마이크가 설치되어 있는지 여부는 검색되지 않습니다. 사용자가 제대로 설치된 입력 사용 사운드 카드 작동 드라이버가 있는지 여부만 검색할 수 있습니다.)
const unsigned longLISTEN_STATUS_NOTTOPMOST = 2;	다른 클라이언트는 이 문자의 활성 클라이언트이거나 현재 문자가 맨 위에 있지 않습니다.
const unsigned longLISTEN_STATUS_CANTOPENAUDIO = 3;	오디오 입력 또는 출력 채널이 현재 사용 중입니다. 다른 응용 프로그램에서는 오디오를 사용하고 있습니다.
const unsigned longLISTEN_STATUS_COULDNTINITIALIZESPEECH = 4;	음성 인식 하위 시스템을 초기화하는 과정에서 지정되지 않은 오류가 발생했습니다. 여기에는 문자의 언어 설정과 일치하는 음성 엔진이 없을 가능성이 포함됩니다.
const unsigned longLISTEN_STATUS_SPEECHDISABLED = 5;	사용자가 고급 문자 옵션 창에서 음성 입력을 사용하지 않도록 설정했습니다.
const unsigned longLISTEN_STATUS_ERROR = 6;	오디오 상태 확인하는 동안 오류가 발생했지만 오류의 원인은 시스템에서 반환되지 않았습니다.

이 함수를 사용하면 오디오 디바이스의 상태 포함하여 현재 조건이 음성 인식 입력을 지원하는지 여부를 쿼리할 수 있습니다. 애플리케이션에서 IAgentCharacterEx::Listen 메서드를 사용하는 경우 이 함수를 사용하여 호출이 성공하는지 더 잘 확인할 수 있습니다. 이 메서드를 호출하면 음성 엔진이 아직 로드되지 않은 경우에도 로드됩니다. 그러나 수신 모드는 켜지지 않습니다.

에이전트 속성 시트(고급 문자 옵션)에서 음성 입력을 사용하도록 설정하면 상태 쿼리하면 연결된 엔진(아직 로드되지 않은 경우)이 로드되고 음성 서비스가 시작됩니다. 즉, 수신 대기 키를 사용할 수 있으며 수신 대기 팁을 표시할 수 있습니다. (수신 키 및 수신 팁은 고급 문자 옵션에서도 사용하도록 설정된 경우에만 사용할 수 있습니다.) 그러나 음성을 사용하지 않도록 설정할 때 속성을 쿼리하는 경우 서버는 음성 서비스를 시작하지 않습니다.

이 함수는 클라이언트 애플리케이션에서 문자를 사용하기 위한 설정만 반환합니다. 설정은 클라이언트 애플리케이션의 문자 또는 다른 문자의 다른 클라이언트를 반영하지 않습니다.