IKeywordDetectorOemAdapter インターフェイス (keyworddetectoroemadapter.h)

IKeywordDetectorOemAdapter は、音声アクティブ化ドライバー インターフェイスと対話するためのコンポーネント オブジェクト モデル (COM) インターフェイスです。 IKeywordDetectorOemAdapter インターフェイスは、Windows 10以降のバージョンの Windows でサポートされています。

OEM は、オペレーティング システムとドライバーの間の仲介役として機能する COM オブジェクトの実装を提供し、 KSPROPERTY_SOUNDDETECTOR_PATTERNS と KSPROPERTY_SOUNDDETECTOR_MATCHRESULTを介してオーディオ ドライバーに書き込まれ、読み取られた不透明なデータを計算または解析するのに役立ちます。

COM オブジェクトのクラス識別子 (CLSID) は、 KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNSによって返される検出パターン型 GUID です。 オペレーティング システムは、パターン型 GUID を渡して CoCreateInstance を呼び出して、キーワード (keyword)パターン型と互換性のある適切な COM オブジェクトをインスタンス化し、オブジェクトの IKeywordDetectorOemAdapter インターフェイスでメソッドを呼び出します。 操作では、 IKeywordDetectorOemAdapter のプロキシ スタブが提供されます。 OEM の実装では、COM スレッド モデルのいずれかを選択できます。

インターフェイスデザインは、オブジェクト実装をステートレスに保つよう試みます。 つまり、実装では、メソッド呼び出しの間に状態を格納する必要はありません。 実際、内部 C++ クラスでは、一般的に COM オブジェクトを実装するために必要なメンバー変数を超えるメンバー変数は必要ない可能性があります。

継承

IKeywordDetectorOemAdapter インターフェイスは、IUnknown インターフェイスから継承します。

メソッド

IKeywordDetectorOemAdapter インターフェイスには、これらのメソッドがあります。

IKeywordDetectorOemAdapter::BuildArmingPatternData BuildArmingPatternData メソッドは、検出用のキーワード (keyword)およびユーザー固有のモデル データを含む OEM 固有のパターン データを構築するために、オペレーティング システムによって呼び出されます。
IKeywordDetectorOemAdapter::ComputeAndAddUserModelData ComputeAndAddUserModelData メソッドは、トレーニング ユーザー エクスペリエンスによって使用され、ユーザーに依存しないキーワード (keyword)に対するユーザー固有の情報を計算します。
IKeywordDetectorOemAdapter::GetCapabilities GetCapabilities メソッドは、 オブジェクトでサポートされているキーワードと言語を返します。
IKeywordDetectorOemAdapter::P arseDetectionResultData ParseDetectionResultData メソッドは、キーワード (keyword)検出イベントを処理した後、KSPROPERTY_SOUNDDETECTOR_MATCHRESULTから結果データを取得した後、オペレーティング システムによって呼び出されます。
IKeywordDetectorOemAdapter::VerifyUserKeyword VerifyUserKeyword メソッドは、トレーニング ユーザー エクスペリエンスによって使用され、トレーニング中にキャプチャされた発話の 1 つのインスタンスが、ある許容範囲内の定義済みのキーワード (keyword)と一致することを確認します。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	keyworddetectoroemadapter.h