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

Article
02/26/2024

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 langue 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 l’IMFMediaType sont les suivantes :

Type = Audio
Sous-type = 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 retournée

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

Valeur retournée	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épendant de l’utilisateur installées avec elle.

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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	keyworddetectoroemadapter.h