KSPROPERTY_SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_PATTERNS屬性是由作業系統設定，以設定要偵測的關鍵字。

OS 會設定關鍵字模式，或將此設定為空值。

當 OS 設定這個屬性時，如果先前已開啟，驅動程式就會自動解除偵測器。

如果驅動程式因資源不足而無法滿足「設定」要求，驅動程式就會因為 STATUS_INSUFFICIENT_RESOURCES而失敗要求。

使用量摘要資料表 - KSPROPSETID_SoundDetector

此使用方式資料表摘要說明使用 KSPROPSETID_SoundDetector呼叫KSPROPERTY_SOUNDDETECTOR_ARMED

Get	集合	目標	屬性描述項類型	屬性值類型
否	是	篩選	KSPROPERTY	KSMULTIPLE_ITEM

使用量摘要資料表 - KSPROPSETID_SoundDetector2

此使用方式資料表摘要說明使用 KSPROPSETID_SoundDetector2呼叫KSPROPERTY_SOUNDDETECTOR_ARMED

Get	集合	目標	屬性描述項類型	屬性值類型
否	是	篩選	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

傳回值

屬性值是 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

另請參閱

SOUNDDETECTOR_PATTERNHEADER

SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_ARMED

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

KSPROPERTY

KSMULTIPLE_ITEM