IKeywordDetectorOemAdapter::BuildArmingPatternData 方法 (keyworddetectoroemadapter.h)

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
KeywordIdLangId 參數無效。
HRESULT_FROM_WIN32 (ERROR_GEN_FAILURE)
處理無法完成。

備註

操作系統可以隨時呼叫這個方法。 操作系統也可以儲存傳回的模式數據,以便稍後針對同一組關鍵詞選取器重複使用。

規格需求

需求
最低支援的用戶端 Windows 10
最低支援的伺服器 Windows Server 2016
目標平台 Windows
標頭 keyworddetectoroemadapter.h

另請參閱

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

KEYWORDSELECTOR