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

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

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

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

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

継承

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

メソッド

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

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

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	keyworddetectoroemadapter.h