Partager via


KSPROPERTY_SOUNDDETECTOR_PATTERNS

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 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.

Configuration requise

Client minimal pris en charge

Windows 10

Serveur minimal pris en charge

Windows Server 2016

En-tête

Ksmedia.h

Voir aussi

SOUNDDETECTOR_PATTERNHEADER

SOUNDDETECTOR_PATTERNS

KSPROPERTY_SOUNDDETECTOR_ARMED

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

KSPROPERTY

KSMULTIPLE_ITEM