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