KSPROPERTY_SOUNDDETECTOR_PATTERNS
KSPROPERTY_SOUNDDETECTOR_PATTERNS 属性由操作系统设置，以配置要检测的关键字。
操作系统设置关键字模式，或者可以将其设置为空值。
当操作系统设置此属性时，驱动程序会自动解除检测器的防护（如果之前已防护）。
如果驱动程序由于资源不足而无法满足“set”请求，驱动程序将以 STATUS_INSUFFICIENT_RESOURCES 请求失败。
使用情况摘要表 - KSPROPSETID_SoundDetector
此使用情况表汇总了使用 KSPROPSETID_SoundDetector 调用 KSPROPERTY_SOUNDDETECTOR_ARMED
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
否 |
是 |
筛选器 |
使用情况摘要表 - KSPROPSETID_SoundDetector2
此使用情况表汇总了使用 KSPROPSETID_SoundDetector2 调用 KSPROPERTY_SOUNDDETECTOR_ARMED
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
否 |
是 |
筛选器 |
返回值
属性值是一个 KSMULTIPLE_ITEM 结构，后跟 64 位对齐检测模式的序列。 每个模式都以 SOUNDDETECTOR_PATTERNHEADER 开头，后跟模式有效负载。
注解
驱动程序在下列情况下才可完成“set”请求：
- 检测器已解除防护，后续的“get”请求在 KSPROPERTY_SOUNDDETECTOR_ARMED 返回 false。
- 后续的“get”请求在 KSPROPERTY_SOUNDDETECTOR_MATCHRESULT 不返回任何数据。
- 建立了新的关键字模式，关键字检测器在新模式上运行。
驱动程序可能会使请求保持挂起状态，直到满足上述条件。 此外，如果设备需要可测量的初始化时间，驱动程序可能会使此请求保持挂起状态，直到设备准备就绪，并且可以处理请求。
操作系统需要这种行为来避免检测到的关键字和更新关键字模式之间的竞争条件（例如，如果检测到关键字并且 KSEVENT_SOUNDDETECTOR 在操作系统更新关键字之前生成）。
操作系统至少等待 2 秒来完成此请求。
要求
最低受支持的客户端 |
Windows 10 |
最低受支持的服务器 |
Windows Server 2016 |
标头 |
Ksmedia.h |
另请参阅
KSPROPERTY_SOUNDDETECTOR_ARMED