KSPROPERTY_SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_PATTERNS 属性由操作系统设置,以配置要检测的关键字。

操作系统设置关键字模式,或者可以将其设置为空值。

当操作系统设置此属性时,驱动程序会自动解除检测器的防护(如果之前已防护)。

如果驱动程序由于资源不足而无法满足“set”请求,驱动程序将以 STATUS_INSUFFICIENT_RESOURCES 请求失败。

使用情况摘要表 - KSPROPSETID_SoundDetector

此使用情况表汇总了使用 KSPROPSETID_SoundDetector 调用 KSPROPERTY_SOUNDDETECTOR_ARMED

获取 设置 目标 属性描述符类型 属性值类型

筛选器

KSPROPERTY

KSMULTIPLE_ITEM

使用情况摘要表 - KSPROPSETID_SoundDetector2

此使用情况表汇总了使用 KSPROPSETID_SoundDetector2 调用 KSPROPERTY_SOUNDDETECTOR_ARMED

获取 设置 目标 属性描述符类型 属性值类型

筛选器

KSSOUNDDETECTORPROPERTY

KSMULTIPLE_ITEM

返回值

属性值是一个 KSMULTIPLE_ITEM 结构,后跟 64 位对齐检测模式的序列。 每个模式都以 SOUNDDETECTOR_PATTERNHEADER 开头,后跟模式有效负载。

注解

驱动程序在下列情况下才可完成“set”请求:

驱动程序可能会使请求保持挂起状态,直到满足上述条件。 此外,如果设备需要可测量的初始化时间,驱动程序可能会使此请求保持挂起状态,直到设备准备就绪,并且可以处理请求。

操作系统需要这种行为来避免检测到的关键字和更新关键字模式之间的竞争条件(例如,如果检测到关键字并且 KSEVENT_SOUNDDETECTOR 在操作系统更新关键字之前生成)。

操作系统至少等待 2 秒来完成此请求。

要求

最低受支持的客户端

Windows 10

最低受支持的服务器

Windows Server 2016

标头

Ksmedia.h

另请参阅

SOUNDDETECTOR_PATTERNHEADER

SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_ARMED

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

KSPROPERTY

KSMULTIPLE_ITEM