KSPROPSETID_SoundDetector2

Le KSPROPSETID_SoundDetector2 jeu de propriétés contient des propriétés utilisées pour inscrire un filtre pour un périphérique de capture audio qui prend également en charge un détecteur. Le filtre a une fabrique de broches KS qui a une catégorie de broches KSNODETYPE_AUDIO_KEYWORDDETECTOR. Il ne peut pas y avoir plusieurs fabriques de broches ayant cette catégorie de broche KS dans un filtre KS donné instance.

KSPROPSETID_SoundDetector2est pris en charge dans Windows 10 version 1903 et ultérieure. Le jeu de propriétés KSPROPSETID_SoundDetector2 est utilisé pour prendre en charge plusieurs agents vocaux. Pour plus d’informations, consultez Assistant vocal multiple. KSPROPSETID_SoundDetector jeu de propriétés est utilisé sur les systèmes qui prennent uniquement en charge Cortana.

KSPROPSETID_SoundDetector2 utilise la structure KSSOUNDDETECTORPROPERTY , au lieu d’une KSPROPERTY :

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

Toutes les propriétés KSPROPSETID_SoundDetector2 sont appelées avec une structure de données KSSOUNDDETECTORPROPERTY . Cette structure de données contient un KSPROPERTY et l’ID d’événement pour que le mot clé être armé, réinitialisé, détecté, etc.

Le fichier d’en-tête définit le jeu de propriétés KSPROPSETID_SoundDetector2 comme suit :

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

Le KSPROPSETID_SoundDetector2 jeu de propriétés contient les propriétés suivantes :

• KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS : cette propriété est définie par le système d’exploitation pour configurer les mots clés à détecter.

• KSPROPERTY_SOUNDDETECTOR_PATTERNS : le filtre KS du pilote prend en charge cette propriété en lecture/écriture. Le système d’exploitation définit cette propriété pour configurer les mots clés à détecter.

• KSPROPERTY_SOUNDDETECTOR_ARMED : cette propriété en lecture/écriture est simplement une status booléenne indiquant si le détecteur est armé. Le système d’exploitation définit cela pour engager le détecteur mot clé. Le système d’exploitation peut effacer ce problème pour le désengager. Le pilote efface automatiquement cela lorsque mot clé modèles sont définis et également après la détection d’un mot clé. (Le système d’exploitation doit se réarmer.)

• KSPROPERTY_SOUNDDETECTOR_RESET : réinitialisez le détecteur à un état non armé sans aucun modèle défini.

• KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT - Utilisation future uniquement pour les détecteurs d’apparition vocale. Échec de cette requête indiquant que la propriété n’est pas prise en charge ou réussit et retourne true pour tous les autres pilotes.

Au moment de mot clé détection, une notification PNP contenant KSNOTIFICATIONID_SoundDetector est envoyée. REMARQUE : Il ne s’agit pas d’un événement KSEvent, mais plutôt d’un événement PNP qui est envoyé, avec une charge utile, via IoReportTargetDeviceChangeAsynchronous.