KSPROPSETID_SoundDetector2

El KSPROPSETID_SoundDetector2 conjunto de propiedades contiene propiedades que se usan para registrar un filtro para un dispositivo de captura de audio que también admite un detector. El filtro tiene un generador de patillas KS que tiene KSNODETYPE_AUDIO_KEYWORDDETECTOR de categoría de patillas. No puede haber más de un generador de patillas que tenga esta categoría de patillas KS en una instancia de filtro KS determinada.

KSPROPSETID_SoundDetector2se admite en Windows 10 versión 1903 y posteriores. El conjunto de propiedades KSPROPSETID_SoundDetector2 se usa para admitir varios agentes de voz. Para obtener más información, consulte Asistente para voz múltiple. KSPROPSETID_SoundDetector conjunto de propiedades se usa en sistemas que solo admiten Cortana.

KSPROPSETID_SoundDetector2 usa la estructura KSSOUNDDETECTORPROPERTY , en lugar de KSPROPERTY:

typedef struct {
    KSPROPERTY  Property;
    GUID        EventId;
} KSSOUNDDETECTORPROPERTY, *PKSSOUNDDETECTORPROPERTY;

Se llama a todas las propiedades KSPROPSETID_SoundDetector2 con una estructura de datos KSSOUNDDETECTORPROPERTY . Esta estructura de datos contiene un KSPROPERTY y el identificador de evento de la palabra clave que se va a armar, restablecer, detectar, etc.

El archivo de encabezado define la propiedad KSPROPSETID_SoundDetector2 establecida de la siguiente manera:

#define STATIC_KSPROPSETID_SoundDetector2\
    0xfe07e322, 0x450c, 0x4bd5, 0x84, 0xca, 0xa9, 0x48, 0x50, 0xe, 0xa6, 0xaa
DEFINE_GUIDSTRUCT("FE07E322-450C-4BD5-84CA-A948500EA6AA", KSPROPSETID_SoundDetector2);

El KSPROPSETID_SoundDetector2 conjunto de propiedades contiene las siguientes propiedades:

• KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS : el sistema operativo establece esta propiedad para configurar las palabras clave que se van a detectar.

• KSPROPERTY_SOUNDDETECTOR_PATTERNS : el filtro KS del controlador admite esta propiedad de lectura y escritura. El sistema operativo establece esta propiedad para configurar las palabras clave que se van a detectar.

• KSPROPERTY_SOUNDDETECTOR_ARMED : esta propiedad de lectura y escritura es simplemente un estado booleano que indica si el detector está armado. El sistema operativo establece esto para que interactúe con el detector de palabras clave. El sistema operativo puede borrar esto para desasociar. El controlador borra esto automáticamente cuando se establecen patrones de palabra clave y también después de detectar una palabra clave. (El sistema operativo debe rediseñarse).

• KSPROPERTY_SOUNDDETECTOR_RESET : restablezca el detector a un estado desarmado sin ningún patrón establecido.

• KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT : uso futuro solo para detectores de inicio de voz. Se produce un error en esta solicitud que indica que la propiedad no se admite o se ejecuta correctamente y devuelve true para todos los demás controladores.

En el momento de la detección de palabras clave, se envía una notificación PNP que contiene KSNOTIFICATIONID_SoundDetector. NOTA: Esto no es un KSEvent, sino un evento PNP que se envía, con una carga, a través de IoReportTargetDeviceChangeAsynchronous.