共用方式為


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