KSPROPERTY_SOUNDDETECTOR_PATTERNS

Article
06/14/2023

La propriété KSPROPERTY_SOUNDDETECTOR_PATTERNS est définie par le système d’exploitation pour configurer les mots clés à détecter.

Le système d’exploitation définit les modèles mot clé ou peut définir cette valeur sur une valeur vide.

Lorsque le système d’exploitation définit cette propriété, le pilote désarme automatiquement le détecteur s’il était précédemment armé.

Si le pilote ne peut pas satisfaire une demande « définie » en raison de ressources insuffisantes, il échoue à la demande avec STATUS_INSUFFICIENT_RESOURCES.

Tableau récapitulatif de l’utilisation - KSPROPSETID_SoundDetector

Cette table d’utilisation récapitule quand KSPROPERTY_SOUNDDETECTOR_ARMED est appelé avec KSPROPSETID_SoundDetector

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Non	Oui	Filtrer	KSPROPERTY	KSMULTIPLE_ITEM

Tableau récapitulatif de l’utilisation - KSPROPSETID_SoundDetector2

Cette table d’utilisation résume le moment où KSPROPERTY_SOUNDDETECTOR_ARMED est appelé avec KSPROPSETID_SoundDetector2

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Non	Oui	Filtrer	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

Valeur de retour

La valeur de la propriété est une structure KSMULTIPLE_ITEM suivie d’une séquence de modèles de détection alignés sur 64 bits. Chaque modèle commence par un SOUNDDETECTOR_PATTERNHEADER suivi de la charge utile du modèle.

Notes

Le pilote ne doit pas terminer la demande « set » tant que :

Le détecteur est désarmé et les requêtes « get » suivantes sur KSPROPERTY_SOUNDDETECTOR_ARMED retournent false.
Les requêtes « get » suivantes sur KSPROPERTY_SOUNDDETECTOR_MATCHRESULT ne retournent aucune donnée.
Les nouveaux modèles mot clé sont établis et le détecteur de mot clé fonctionne sur les nouveaux modèles.

Le pilote peut maintenir la demande en attente jusqu’à ce que les conditions ci-dessus soient remplies. En outre, si l’appareil nécessite un temps d’initialisation mesurable, le pilote peut garder cette requête en attente jusqu’à ce que l’appareil soit prêt et que le puisse traiter la demande.

Le système d’exploitation exige ce comportement pour éviter les conditions de concurrence entre un mot clé détecté et des modèles de mot clé de mise à jour (par exemple, si un mot clé a été détecté et que le KSEVENT_SOUNDDETECTOR généré un instant avant que le système d’exploitation met à jour les mots clés).

Le système d’exploitation attend au moins 2 secondes que cette demande se termine.