KSPROPERTY_SOUNDDETECTOR_PATTERNS
El sistema operativo establece la propiedad KSPROPERTY_SOUNDDETECTOR_PATTERNS para configurar las palabras clave que se van a detectar.
El sistema operativo establece los patrones de palabra clave o puede establecerlo en un valor vacío.
Cuando el sistema operativo establece esta propiedad, el controlador desarme automáticamente el detector si estaba armado anteriormente.
Si el controlador no puede satisfacer una solicitud "set" debido a recursos insuficientes, se produce un error en la solicitud con STATUS_INSUFFICIENT_RESOURCES.
Tabla de resumen de uso: KSPROPSETID_SoundDetector
Esta tabla de uso resume cuándo se llama a KSPROPERTY_SOUNDDETECTOR_ARMED con KSPROPSETID_SoundDetector
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
No |
Sí |
Filtrar |
Tabla de resumen de uso: KSPROPSETID_SoundDetector2
Esta tabla de uso resume cuándo se llama a KSPROPERTY_SOUNDDETECTOR_ARMED con KSPROPSETID_SoundDetector2
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
No |
Sí |
Filtrar |
Valor devuelto
El valor de la propiedad es una estructura KSMULTIPLE_ITEM seguida de una secuencia de patrones de detección alineados de 64 bits. Cada patrón comienza con un SOUNDDETECTOR_PATTERNHEADER seguido de la carga del patrón.
Observaciones
El conductor no completará la solicitud "establecida" hasta que:
- El detector está desarmado y las solicitudes "get" posteriores en KSPROPERTY_SOUNDDETECTOR_ARMED devuelven false.
- Las solicitudes "get" posteriores en KSPROPERTY_SOUNDDETECTOR_MATCHRESULT no devuelven datos.
- Se establecen los nuevos patrones de palabra clave y el detector de palabras clave funciona en los nuevos patrones.
El controlador puede mantener la solicitud pendiente hasta que se cumplan las condiciones anteriores. Además, si el dispositivo requiere un tiempo de inicialización medible, el controlador puede mantener esta solicitud pendiente hasta que el dispositivo esté listo y pueda procesar la solicitud.
El sistema operativo requiere este comportamiento para evitar condiciones de carrera entre una palabra clave detectada y la actualización de patrones de palabras clave (por ejemplo, si se detectó una palabra clave y el KSEVENT_SOUNDDETECTOR generó un instante antes de que el sistema operativo actualice las palabras clave).
El sistema operativo espera al menos 2 segundos para que se complete esta solicitud.
Requisitos
Cliente mínimo compatible |
Windows 10 |
Servidor mínimo compatible |
Windows Server 2016 |
Encabezado |
Ksmedia.h |
Vea también
KSPROPERTY_SOUNDDETECTOR_ARMED