Метод IKeywordDetectorOemAdapter::GetCapabilities (keyworddetectoroemadapter.h)

Статья
02/07/2025

Метод 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.

Ниже приведены только допустимые значения ДЛЯ МВФMediaType:

Type = Audio
Подтип = IEEE_FLOAT
Частота выборки = 16 кГц
Bits = 32

Как правило, OEMDLL вызывает MFCreateMediaType и MFInitMediaTypeFromWaveFormatEx для получения указателя IMFMediaType для возврата вызывающей стороны.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемое значение	Описание
S_OK	Функция завершилась успешно.
E_POINTER	Указатель для выходного параметра NULL.
E_INVALIDARG	Указатель на данные модели — null.

Замечания

Сведения, возвращаемые этой подпрограммой, обычно не изменяются для данной версии OEMDLL или пользовательских независимых данных модели, установленных вместе с ним.

OEMDLL должен иметь внутренние независимые модели пользователей для ключевых слов и языков, возвращаемых этим методом.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	keyworddetectoroemadapter.h