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

指向 对象支持的关键字 (keyword) ID 数组的指针。 对象通过调用 CoTaskMemAlloc 来分配数组。 调用方通过调用 CoTaskMemFree 释放内存。

[out] NumKeywords

KeywordIds 数组中的关键字 (keyword) ID 数。

[out] LangIds

指向 对象支持的语言 ID 数组的指针。 对象通过调用 CoTaskMemAlloc 来分配数组。 调用方通过调用 CoTaskMemFree 释放内存。

[out] NumLanguages

LangIds 数组中的语言 ID 数。

[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