KSPROPERTY_SOUNDDETECTOR_PATTERNS
KSPROPERTY_SOUNDDETECTOR_PATTERNS屬性是由作業系統設定，以設定要偵測的關鍵字。
OS 會設定關鍵字模式，或將此設定為空值。
當 OS 設定這個屬性時，如果先前已開啟，驅動程式就會自動解除偵測器。
如果驅動程式因資源不足而無法滿足「設定」要求，驅動程式就會因為 STATUS_INSUFFICIENT_RESOURCES而失敗要求。
使用量摘要資料表 - KSPROPSETID_SoundDetector
此使用方式資料表摘要說明使用 KSPROPSETID_SoundDetector呼叫KSPROPERTY_SOUNDDETECTOR_ARMED
| Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
否 |
是 |
篩選 |
使用量摘要資料表 - KSPROPSETID_SoundDetector2
此使用方式資料表摘要說明使用 KSPROPSETID_SoundDetector2呼叫KSPROPERTY_SOUNDDETECTOR_ARMED
| Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
否 |
是 |
篩選 |
傳回值
屬性值是 KSMULTIPLE_ITEM 結構，後面接著 64 位對齊偵測模式的序列。 每個模式都是以 SOUNDDETECTOR_PATTERNHEADER 開頭，後面接著模式承載。
備註
驅動程式必須等到下列時間才能完成「設定」要求：
- 偵測器會在KSPROPERTY_SOUNDDETECTOR_ARMED傳回 false，並解除後續 的 「取得」要求。
- KSPROPERTY_SOUNDDETECTOR_MATCHRESULT上的後續「取得」要求不會傳回任何資料。
- 會建立新的關鍵字模式，而且關鍵字偵測器正在新模式上運作。
驅動程式可能會讓要求保持擱置，直到符合上述條件為止。 此外，如果裝置需要可測量的初始化時間，驅動程式可能會讓此要求擱置中，直到裝置就緒且可以處理要求為止。
OS 需要此行為，以避免偵測到關鍵字與更新關鍵字模式之間的競爭條件 (，例如，如果偵測到關鍵字，而且KSEVENT_SOUNDDETECTOR在 OS 更新關鍵字) 之前產生立即。
OS 至少等候 2 秒，此要求才能完成。
規格需求
最低支援的用戶端 |
Windows 10 |
最低支援的伺服器 |
Windows Server 2016 |
標頭 |
Ksmedia.h |
另請參閱
KSPROPERTY_SOUNDDETECTOR_ARMED