KSPROPERTY_SOUNDDETECTOR_PATTERNS

Artículo
06/15/2023

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	KSPROPERTY	KSMULTIPLE_ITEM

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	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

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.