KSPROPERTY_SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_PATTERNS プロパティは、検出するキーワードを構成するためにオペレーティングシステムによって設定されます。

OS は、キーワードパターンを設定するか、空の値に設定できます。

OS がこのプロパティを設定すると、ドライバーは、以前に作動していた場合に自動的に検出機能を解除します。

リソース不足が原因で、ドライバーが「set」要求を満たせない場合、ドライバーは、STATUS_INSUFFICIENT_RESOURCES を使用した要求に失敗します。

この使用表は、KSPROPERTY_SOUNDDETECTOR_ARMED が KSPROPSETID_SoundDetector で呼び出された際の概要です。

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
いいえ	はい	Assert	KSPROPERTY	KSMULTIPLE_ITEM

この使用表は、KSPROPERTY_SOUNDDETECTOR_ARMED が KSPROPSETID_SoundDetector2 で呼び出された際の概要です。

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
いいえ	はい	Assert	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

プロパティ値は、KSMULTIPLE_ITEM 構造体の後に、64 ビットアライン検出パターンのシーケンスが続きます。各パターンは、SOUNDDETECTOR_PATTERNHEADER で始まり、その後にパターンペイロードが続きます。

解説

ドライバーは、次の場合まで「set」要求を完了することはできません。

ドライバーは、上記の条件が満たされるまで、要求を保留中のままにすることがあります。また、デバイスで測定可能な初期化時間が必要な場合、ドライバーは、デバイスの準備が整い、要求を処理できるようになるまで、この要求を保留にしておく可能性があります。

OS では、検出されたキーワードとキーワードパターンの更新間の競合状態を回避するために、この動作が必要です (たとえば、キーワードが検出され、キーワードが更新される前に KSEVENT_SOUNDDETECTOR が生成された場合など)。

OS は、この要求が完了するまで少なくとも 2 秒待機します。