Metodo IKeywordDetectorOemAdapter::GetCapabilities (keyworddetectoroepter.h)

Articolo
02/07/2025

Il metodo GetCapabilities restituisce le parole chiave e le lingue supportate dall'oggetto .

Sintassi

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

Parametri

[in] SupportsUserModels

Valore booleano che indica se è supportato un training specifico dell'utente.

[out] KeywordIds

Puntatore a una matrice di ID di parole chiave supportati dall'oggetto . L'oggetto alloca la matrice chiamando CoTaskMemAlloc. Il chiamante libera la memoria chiamando CoTaskMemFree.

[out] NumKeywords

Numero di ID di parole chiave nella matrice KeywordIds.

[out] LangIds

Puntatore a una matrice di ID lingua supportati dall'oggetto . L'oggetto alloca la matrice chiamando CoTaskMemAlloc. Il chiamante libera la memoria chiamando CoTaskMemFree.

[out] NumLanguages

Numero di ID lingua nella matrice LangIds.

[out] ppMediaType

Formato audio richiesto da IKeywordDetectorOemAdapter::VerifyUserKeyword e IKeywordDetectorOemAdapter::ComputeAndAddUserModelData.

Gli unici valori validi per IMFMediaType sono i seguenti:

Tipo = Audio
Sottotipo = IEEE_FLOAT
Frequenza di campionamento = 16 kHz
Bit = 32

In genere, OEMDLL chiama MFCreateMediaType e MFInitMediaTypeFromWaveFormatEx per ottenere un puntatore IMFMediaType per tornare al chiamante.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore restituito	Descrizione
S_OK	La funzione è stata chiusa correttamente.
E_POINTER	Il puntatore per un parametro di output è NULL.
E_INVALIDARG	Il puntatore ai dati del modello è NULL.

Osservazioni

Le informazioni restituite da questa routine normalmente non cambiano per una determinata versione dell'OEMDLL o i dati del modello indipendente dall'utente installati insieme a esso.

OEMDLL deve avere modelli interni indipendenti dall'utente per le parole chiave e le lingue restituite da questo metodo.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	keyworddetectoroepter.h