IKeywordDetectorOemAdapter ::GetCapabilities, méthode (keyworddetectoroemadapter.h)

Article
02/07/2025

La méthode GetCapabilities retourne les mots clés et les langages pris en charge par l’objet.

Syntaxe

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

Paramètres

[in] SupportsUserModels

Valeur booléenne qui indique si l’entraînement spécifique de l’utilisateur est pris en charge.

[out] KeywordIds

Pointeur vers un tableau d’ID de mot clé pris en charge par l’objet. L’objet alloue le tableau en appelant CoTaskMemAlloc. L’appelant libère la mémoire en appelant CoTaskMemFree.

[out] NumKeywords

Nombre d’ID de mot clé dans le tableau KeywordIds.

[out] LangIds

Pointeur vers un tableau d’ID de langage pris en charge par l’objet. L’objet alloue le tableau en appelant CoTaskMemAlloc. L’appelant libère la mémoire en appelant CoTaskMemFree.

[out] NumLanguages

Nombre d’ID de langue dans le tableau LangIds.

[out] ppMediaType

Format audio requis par IKeywordDetectorOemAdapter ::VerifyUserKeyword et IKeywordDetectorOemAdapter ::ComputeAndAddUserModelData.

Les seules valeurs valides pour IMFMediaType sont les suivantes :

Type = Audio
Subtype = IEEE_FLOAT
Taux d’échantillonnage = 16 kHz
Bits = 32

En règle générale, l’OEMDLL appelle MFCreateMediaType et MFInitMediaTypeFromWaveFormatEx pour obtenir un pointeur IMFMediaType pour revenir à l’appelant.

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Valeur de retour	Description
S_OK	La fonction s’est terminée avec succès.
E_POINTER	Le pointeur d’un paramètre de sortie est NULL .
E_INVALIDARG	Le pointeur vers les données du modèle est NULL .

Remarques

Les informations retournées par cette routine ne changent normalement pas pour une version donnée de l’OEMDLL ou des données de modèle indépendantes de l’utilisateur installées avec celle-ci.

L’OEMDLL doit avoir des modèles internes indépendants de l’utilisateur pour les mots clés et les langues retournés par cette méthode.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
d’en-tête	keyworddetectoroemadapter.h