Método IKeywordDetectorOemAdapter::GetCapabilities (keyworddetectoroemadapter.h)

Artigo
02/07/2025

O método GetCapabilities retorna as palavras-chave e idiomas compatíveis com o objeto.

Sintaxe

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

Parâmetros

[in] SupportsUserModels

Um valor booliano que indica se há suporte para treinamento específico do usuário.

[out] KeywordIds

Um ponteiro para uma matriz de IDs de palavra-chave com suporte pelo objeto. O objeto aloca a matriz chamando CoTaskMemAlloc. O chamador libera a memória chamando CoTaskMemFree.

[out] NumKeywords

O número de IDs de palavra-chave na matriz KeywordIds.

[out] LangIds

Um ponteiro para uma matriz de IDs de idioma compatíveis com o objeto. O objeto aloca a matriz chamando CoTaskMemAlloc. O chamador libera a memória chamando CoTaskMemFree.

[out] NumLanguages

O número de IDs de idioma na matriz langIds do.

[out] ppMediaType

O formato de áudio exigido pelo IKeywordDetectorOemAdapter::VerifyUserKeyword e IKeywordDetectorOemAdapter::ComputeAndAddUserModelData.

Os únicos valores válidos para o IMFMediaType são os seguintes:

Tipo = Áudio
Subtipo = IEEE_FLOAT
Taxa de Amostragem = 16 kHz
Bits = 32

Normalmente, o OEMDLL chama MFCreateMediaType e MFInitMediaTypeFromWaveFormatEx para obter um ponteiro IMFMediaType para retornar ao chamador.

Valor de retorno

Esse método pode retornar um desses valores.

Valor de retorno	Descrição
S_OK	A função foi encerrada com êxito.
E_POINTER	O ponteiro para um parâmetro de saída é NULL.
E_INVALIDARG	O ponteiro para os dados do modelo é NULL.

Observações

As informações retornadas dessa rotina normalmente não seriam alteradas para uma determinada versão do OEMDLL ou os dados de modelo independentes do usuário instalados junto com ele.

O OEMDLL deve ter modelos internos independentes do usuário para as palavras-chave e idiomas retornados desse método.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	keyworddetectoroemadapter.h

Consulte também

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IKeywordDetectorOemAdapter::ComputeAndAddUserModelData

IKeywordDetectorOemAdapter::VerifyUserKeyword

IMFMediaType

MFCreateMediaType

MFInitMediaTypeFromWaveFormatEx

Partilhar via