IAgentNotifySinkEx::ListeningState

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

HRESULT ListeningState(
   long dwCharacterID,  // character ID
   long bListening,     // listening mode state
   long dwCause         // cause  
);

수신 모드가 변경되면 클라이언트 애플리케이션에 알 수 있습니다.

• 반환 값이 없습니다.

dwCharacterID

수신 대기 상태가 변경된 문자입니다.

bListening

수신 모드 상태입니다. True 이면 수신 모드가 시작되었음을 나타냅니다. False, 수신 모드가 종료되었습니다.

dwCause

다음 값 중 하나일 수 있는 이벤트의 원인입니다.

값	설명
const unsigned longLSCOMPLETE_CAUSE_PROGRAMDISABLED = 1;	프로그램 코드에 의해 수신 모드가 해제되었습니다.
const unsigned longLSCOMPLETE_CAUSE_PROGRAMTIMEDOUT = 2;	수신 모드(프로그램 코드에 의해 켜짐)가 시간 초과되었습니다.
const unsigned longLSCOMPLETE_CAUSE_USERTIMEDOUT = 3;	수신 대기 모드(수신 대기 키에 의해 켜짐)가 시간 초과되었습니다.
const unsigned longLSCOMPLETE_CAUSE_USERRELEASEDKEY = 4;	사용자가 수신 대기 키를 해제했기 때문에 수신 모드가 해제되었습니다.
const unsigned longLSCOMPLETE_CAUSE_USERUTTERANCEENDED = 5;	사용자가 말하기를 마쳤기 때문에 수신 모드가 꺼졌습니다.
const unsigned longLSCOMPLETE_CAUSE_CLIENTDEACTIVATED = 6;	입력 활성 클라이언트가 비활성화되어 수신 모드가 해제되었습니다.
const unsigned longLSCOMPLETE_CAUSE_DEFAULTCHARCHANGE = 7	기본 문자가 변경되어 수신 모드가 해제되었습니다.
const unsigned longLSCOMPLETE_CAUSE_USERDISABLED = 8	사용자가 음성 입력을 사용하지 않도록 설정했기 때문에 수신 모드가 해제되었습니다.

이 이벤트는 사용자가 수신 대기 키를 누른 후 또는 시간 초과가 종료되거나 입력 활성 클라이언트가 True 또는 False를 사용하여 IAgentCharacterEx::Listen 메서드를 호출할 때 수신 모드가 시작될 때 모든 클라이언트에 전송됩니다.

이벤트는 현재 이 문자가 로드된 클라이언트에 값을 반환합니다. 다른 모든 클라이언트는 null 문자(빈 문자열)를 받습니다.

참고 항목

IAgentCharacterEx::Listen