Share via


IAgentUserInput::GetAllItemData

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

HRESULT GetAllItemData(
   VARIANT * pdwItemIndices,  // address of variable for alternative IDs
   VARIANT * plConfidences,   // address of variable for confidence scores
   VARIANT * pbszText         // address of variable for voice text
);

IAgentNotifySink::Command 콜백에 전달된 모든 명령 대안에 대한 데이터를 검색합니다.

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

pdwItemIndices

IAgentNotifySink::Command 콜백에 전달된 명령의 ID를 수신하는 변수의 주소입니다.

plConfidences

IAgentNotifySink::Command 콜백에 전달된 명령 대체에 대한 신뢰도 점수를 받는 변수의 주소입니다.

pbszText

IAgentNotifySink::Command 콜백에 전달된 명령 대체에 대한 음성 텍스트를 수신하는 변수의 주소입니다.

음성 입력이 IAgentNotifySink::Command를 트리거하는 경우 서버는 음성 엔진에서 제공하는 경우 가장 일치하는 항목, 두 번째 일치 항목 및 세 번째로 일치하는 항목을 반환합니다. -100~100 범위의 상대적 신뢰도 점수와 음성 엔진에서 "들은" 실제 텍스트를 제공합니다. 가장 일치하는 항목이 서버 제공 명령인 경우 서버는 NULL ID를 보내지만 여전히 신뢰도 점수와 음성 텍스트를 보냅니다.

음성 입력이 이벤트의 원본이 아닌 경우 예를 들어 사용자가 문자의 팝업 메뉴에서 명령을 선택한 경우 Microsoft 에이전트 서버는 신뢰도 점수가 100이고 음성 텍스트가 NULL인 선택한 명령 의 ID를 반환합니다. 다른 대안은 신뢰도 점수가 0이고 음성 텍스트가 NULL인 NULL로 반환됩니다.

참고

모든 음성 인식 엔진이 이 이벤트의 모든 매개 변수에 대한 모든 값을 반환할 수 있는 것은 아닙니다. 엔진 공급업체에 문의하여 엔진이 대체 및 신뢰도 점수를 반환하기 위해 Microsoft Speech API 인터페이스를 지원하는지 확인합니다.

 

참고 항목

IAgentUserInput::GetItemConfidence, IAgentUserInput::GetItemText, IAgentUserInput::GetItemID