IKeywordDetectorOemAdapter::BuildArmingPatternData 메서드(keyworddetectoroemadapter.h)

BuildArmingPatternData 메서드는 검색을 위해 모든 키워드(keyword) 및 사용자별 모델 데이터를 포함하는 OEM 관련 패턴 데이터를 빌드하기 위해 운영 체제에서 호출됩니다.

구문

HRESULT BuildArmingPatternData(
  [in]  IStream                     *UserModelData,
  [in]  KEYWORDSELECTOR             *KeywordSelectors,
  [in]  ULONG                       NumKeywordSelectors,
  [out] SOUNDDETECTOR_PATTERNHEADER **ppPatternData
);

매개 변수

[in] UserModelData

KeywordSelectors 매개 변수의 KEYWORDSELECTOR 값에 대한 모델 데이터에 바인딩된 IStream에 대한 포인터입니다.

[in] KeywordSelectors

arm에 키워드(keyword) 탐지기에 대해 원하는 일치 집합을 식별하는 KEYWORDSELECTOR 구조체의 배열입니다.

[in] NumKeywordSelectors

KeywordSelectors 배열의 항목 수입니다. 키워드 선택기는 하나만 지원되며 이 필드는 1로 설정해야 합니다.

[out] ppPatternData

오디오 드라이버에 전달할 운영 체제의 패턴 데이터입니다. OEMDLL은 CoTaskMemAlloc를 호출하는 메모리를 할당합니다. 운영 체제는 CoTaskMemFree를 호출하여 메모리를 해제합니다.

반환 값

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

반환 값 설명
S_OK
함수가 성공적으로 종료되었습니다.
E_POINTER
ModelData 포인터가 NULL입니다.
E_INVALIDARG
KeywordId 또는 LangId 매개 변수가 잘못되었습니다.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)
처리를 완료할 수 없습니다.

설명

운영 체제는 언제든지 이 메서드를 호출할 수 있습니다. 운영 체제는 반환된 패턴 데이터를 저장하여 나중에 동일한 키워드(keyword) 선택기 집합에 다시 사용할 수도 있습니다.

요구 사항

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

추가 정보

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

KEYWORDSELECTOR