IKeywordDetectorOemAdapter：：GetCapabilities 方法 (keyworddetectoroemadapter.h)

  • 發行項

GetCapabilities 方法會傳回 物件支援的關鍵詞和語言。

語法

HRESULT GetCapabilities(
  [in]  BOOL         *SupportsUserModels,
  [out] KEYWORDID    **KeywordIds,
  [out] ULONG        *NumKeywords,
  [out] LANGID       **LangIds,
  [out] ULONG        *NumLanguages,
  [out] IMFMediaType **ppMediaType
);

參數

[in] SupportsUserModels

布爾值，指出是否支援使用者特定的訓練。

[out] KeywordIds

物件所支持之關鍵詞標識碼陣列的指標。 物件會呼叫 CoTaskMemAlloc 來配置數位。 呼叫端會藉由呼叫 CoTaskMemFree 釋放記憶體。

[out] NumKeywords

KeywordIds 數位中的關鍵詞標識子數目。

[out] LangIds

物件所支援之語言標識碼陣列的指標。 物件會呼叫 CoTaskMemAlloc 來配置數位。 呼叫端會藉由呼叫 CoTaskMemFree 釋放記憶體。

[out] NumLanguages

LangIds 陣列中的語言標識碼。

[out] ppMediaType

IKeywordDetectorOemAdapter：：VerifyUserKeyword 和 IKeywordDetectorOemAdapter：：ComputeAndAddUserModelData 所需的音訊格式。

IMFMediaType 的唯一有效值如下：

  • 類型 = 音訊
  • 子類型 = IEEE_FLOAT
  • 取樣率 = 16 kHz
  • 位 = 32
一般而言，OEMDLL 會呼叫 MFCreateMediaType 和 MFInitMediaTypeFromWaveFormatEx ，以取得 IMFMediaType 指標以返回呼叫端。

傳回值

這個方法可以傳回下列其中一個值。

傳回值 描述
S_OK
 函式已成功結束。
E_POINTER
 輸出參數的指標為 NULL。
E_INVALIDARG
 模型數據的指標為 NULL。

備註

從這個例程傳回的資訊通常不會變更指定版本的 OEMDLL 或隨其一起安裝的用戶獨立模型數據。

OEMDLL 必須有內部用戶獨立模型，才能使用此方法傳回的關鍵詞和語言。

規格需求

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

另請參閱

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IKeywordDetectorOemAdapter：：ComputeAndAddUserModelData

IKeywordDetectorOemAdapter：：VerifyUserKeyword

IMFMediaType

MFCreateMediaType

MFInitMediaTypeFromWaveFormatEx