IKeywordDetectorOemAdapter::GetCapabilities-Methode (keyworddetectoroemadapter.h)

Artikel
03/01/2024

Die GetCapabilities-Methode gibt die Schlüsselwörter und Sprachen zurück, die vom -Objekt unterstützt werden.

Syntax

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

Parameter

[in] SupportsUserModels

Ein boolescher Wert, der angibt, ob benutzerspezifisches Training unterstützt wird.

[out] KeywordIds

Ein Zeiger auf ein Array von Schlüsselwort (keyword) IDs, die vom -Objekt unterstützt werden. Das -Objekt ordnet das Array zu, indem CoTaskMemAlloc aufgerufen wird. Der Aufrufer gibt den Arbeitsspeicher durch Aufrufen von CoTaskMemFree frei.

[out] NumKeywords

Die Anzahl der Schlüsselwort (keyword) IDs im KeywordIds-Array.

[out] LangIds

Ein Zeiger auf ein Array von Sprach-IDs, die vom -Objekt unterstützt werden. Das -Objekt ordnet das Array zu, indem CoTaskMemAlloc aufgerufen wird. Der Aufrufer gibt den Arbeitsspeicher durch Aufrufen von CoTaskMemFree frei.

[out] NumLanguages

Die Anzahl der Sprach-IDs im LangIds-Array .

[out] ppMediaType

Das für IKeywordDetectorOemAdapter::VerifyUserKeyword und IKeywordDetectorOemAdapter::ComputeAndAddUserModelData erforderliche Audioformat.

Die einzigen gültigen Werte für den IMFMediaType sind die folgenden:

Typ = Audio
Untertyp = IEEE_FLOAT
Samplingrate = 16 kHz
Bits = 32

In der Regel ruft oemDLL MFCreateMediaType und MFInitMediaTypeFromWaveFormatEx auf, um einen IMFMediaType-Zeiger abzurufen, der zum Aufrufer zurückkehren soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert	BESCHREIBUNG
S_OK	Die Funktion wurde erfolgreich beendet.
E_POINTER	Der Zeiger für einen Ausgabeparameter ist NULL.
E_INVALIDARG	Der Zeiger auf die Modelldaten ist NULL.

Hinweise

Die von dieser Routine zurückgegebenen Informationen ändern sich normalerweise nicht für eine bestimmte Version der OEMDLL oder die mit ihr installierten benutzerunabhängigen Modelldaten.

Die OEMDLL muss über interne benutzerunabhängige Modelle für die Schlüsselwörter und Sprachen verfügen, die von dieser Methode zurückgegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	keyworddetectoroemadapter.h