IKeywordDetectorOemAdapter：：BuildArmingPatternData 方法（keyworddetectoroemadapter.h）

2025-02-07

作系统调用 BuildArmingPatternData 方法，以生成特定于 OEM 的模式数据，其中包括用于检测的任何关键字和特定于用户的模型数据。

语法

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

参数

[in] UserModelData

指向 IStream 的指针，该指针绑定到 KeywordSelectors 参数中 KEYWORDSELECTOR 值的模型数据。

[in] KeywordSelectors

一个由 KEYWORDSELECTOR 结构构成的数组，用于标识要武装的关键字检测器所需的匹配集。

[in] NumKeywordSelectors

KeywordSelectors 数组中的项数。仅支持一个关键字选择器，并且此字段必须设置为一个。

[out] ppPatternData

要传递给音频驱动程序的作系统的模式数据。 OEMDLL 分配 CoTaskMemAlloc的内存调用。作系统将通过调用 CoTaskMemFree来释放内存。

返回值

此方法可以返回其中一个值。

返回值	描述
S_OK	函数已成功退出。
E_POINTER	ModelData 指针 NULL。
E_INVALIDARG	KeywordId 或 LangId 参数无效。
HRESULT_FROM_WIN32（ERROR_GEN_FAILURE）	处理无法完成。