IAgentCharacterEx::GetSRModeID

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

HRESULT GetSRModeID(
   BSTR * pbszModeID  // address of speech recognition engine ID
);

문자에 대해 설정된 음성 인식 엔진의 모드 ID를 검색합니다.

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

pbszModeID

문자에 대한 음성 인식 엔진의 모드 ID 설정을 수신하는 BSTR의 주소입니다.

이 설정은 문자의 음성 입력에 대한 엔진 집합을 반환합니다. 음성 인식 엔진의 모드 ID는 엔진을 고유하게 식별하는 음성 공급업체의 GUID(중괄호 및 대시 형식)의 문자열 표현입니다. 자세한 내용은 Microsoft Speech SDK 설명서를 참조하세요.

문자에 대한 음성 인식 엔진 모드 ID를 설정하지 않으면 서버는 문자의 언어 설정과 일치하는 엔진을 반환합니다(Microsoft Speech API 인터페이스 사용). 문자에 사용할 수 있는 일치하는 음성 인식 엔진이 없으면 서버는 null(빈) 문자열을 반환합니다.

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

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

IAgentSpeechInputProperties::GetEnabled가 False를 반환하는 경우 이 함수는 실패하지 않습니다.

Microsoft 에이전트의 음성 엔진 요구 사항은 Microsoft Speech API를 기반으로 합니다. Microsoft 에이전트의 SAPI 요구 사항을 지원하는 엔진을 설치하고 에이전트와 함께 사용할 수 있습니다.

참고 항목

IAgentCharacterEx::SetSRModeID