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

Artigo
02/26/2024

O método GetCapabilities retorna as palavras-chave e os 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 compatíveis com o 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 .

[out] ppMediaType

O formato de áudio exigido por 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, a OEMDLL chama MFCreateMediaType e MFInitMediaTypeFromWaveFormatEx para obter um ponteiro IMFMediaType para retornar ao chamador.

Retornar valor

Esse método pode retornar um desses valores.

Valor retornado	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.

Comentários

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

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Cabeçalho	keyworddetectoroemadapter.h