피드백

IKeywordDetectorOemAdapter::P arseDetectionResultData 메서드(keyworddetectoroemadapter.h)

  • 아티클
  • 읽는 데 3분 걸림

ParseDetectionResultData 메서드는 키워드 검색 이벤트를 처리한 후 KSPROPERTY_SOUNDDETECTOR_MATCHRESULT 결과 데이터를 검색한 후 운영 체제에서 호출됩니다. 운영 체제는 키워드 검색 결과를 가져오기 위해 OEM별 일치 결과 데이터를 이 메서드에 전달합니다. OEMDLL은 결과를 처리하고 일치하는 키워드, 일치하는 키워드와 연결된 언어 및 일치하는 사용자(있는 경우)에 대한 정보를 반환합니다.

구문

HRESULT ParseDetectionResultData(
  [in]  IStream                     *UserModelData,
  [in]  SOUNDDETECTOR_PATTERNHEADER *Result,
  [out] KEYWORDID                   *KeywordId,
  [out] LANGID                      *LangId,
  [out] BOOL                        *pIsUserMatch,
        ULONG64                     *KeywordStartPerformanceCounterValue,
        ULONG64                     *KeywordEndPerformanceCounterValue
);

매개 변수

[in] UserModelData

무장 패턴에 대한 모델 데이터에 바인딩된 IStream 에 대한 포인터입니다.

[in] Result

DDI의 SOUNDDETECTOR_PATTERNHEADER 대한 포인터입니다.

[out] KeywordId

키워드 함수를 식별합니다. 드라이버가 0을 반환하여 일치하지 않음을 나타낼 수 있습니다.

[out] LangId

언어를 식별합니다.

[out] pIsUserMatch

사용자가 일치하는지 나타냅니다.

KeywordStartPerformanceCounterValue

KeywordEndPerformanceCounterValue

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 값 설명
S_OK
 함수가 성공적으로 종료되었습니다.
E_POINTER
 ModelData 포인터가 NULL입니다.
E_INVALIDARG
 KeywordId 또는 LangId 매개 변수가 잘못되었습니다.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)
 처리를 완료할 수 없습니다.
E_HW_RESET
 내부 오류로 인해 하드웨어가 다시 설정됩니다.

설명

드라이버가 키워드 감지기 핀의 버스트 키워드/명령 스트림에 음성 키워드의 일부를 포함하는 경우 드라이버는 KeywordEndTime에 유효한 값을 반환해야 합니다. 그렇지 않으면 드라이버가 필요에 따라 0을 반환할 수 있습니다.

드라이버가 KeywordStartTime 또는 KeywordEndTime을 반환하는 경우 반환된 값은 드라이버의 IMiniportWaveRTInputStream::GetReadPacket 루틴에서 반환된 타임스탬프와 일치해야 합니다.

드라이버가 버스트 키워드/명령 스트림에 음성 키워드의 일부를 포함하는지 여부에 관계없이 드라이버는 KeywordStartTime 및 KeywordEndTime 에 유효한 값을 반환할 수 있습니다.

호출자가 E_HW_RESET 수신하는 경우 하드웨어에서 키워드가 검색되지 않았으며 상태가 손실되었습니다. 모니터링 상태로 돌아가려면 다시 팔이 필요합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 keyworddetectoroemadapter.h

참고 항목

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER