KSPROPERTY_SOUNDDETECTOR_PATTERNS

Articolo
06/15/2023

La proprietà KSPROPERTY_SOUNDDETECTOR_PATTERNS viene impostata dal sistema operativo per configurare le parole chiave da rilevare.

Il sistema operativo imposta i pattern di parole chiave o può impostarlo su un valore vuoto.

Quando il sistema operativo imposta questa proprietà, il driver disarma automaticamente il rilevatore se in precedenza era armato.

Se il driver non riesce a soddisfare una richiesta "set" a causa di risorse insufficienti, il driver non riesce a eseguire la richiesta con STATUS_INSUFFICIENT_RESOURCES.

Tabella riepilogo utilizzo - KSPROPSETID_SoundDetector

Questa tabella di utilizzo riepiloga quando viene chiamato KSPROPERTY_SOUNDDETECTOR_ARMED con KSPROPSETID_SoundDetector

Recupero	Set	Destinazione	Tipo di descrittore di proprietà	Tipo valore proprietà
No	Sì	Filtra	KSPROPERTY	KSMULTIPLE_ITEM

Tabella riepilogo utilizzo - KSPROPSETID_SoundDetector2

Questa tabella di utilizzo riepiloga quando viene chiamato KSPROPERTY_SOUNDDETECTOR_ARMED con KSPROPSETID_SoundDetector2

Recupero	Set	Destinazione	Tipo di descrittore di proprietà	Tipo valore proprietà
No	Sì	Filtra	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

Valore restituito

Il valore della proprietà è una struttura KSMULTIPLE_ITEM seguita da una sequenza di modelli di rilevamento allineati a 64 bit. Ogni modello inizia con un SOUNDDETECTOR_PATTERNHEADER seguito dal payload del modello.

Commenti

Il driver non completerà la richiesta "set" fino a quando:

Il rilevatore viene disarmato e le successive richieste "get" su KSPROPERTY_SOUNDDETECTOR_ARMED restituiscono false.
Le successive richieste "get" su KSPROPERTY_SOUNDDETECTOR_MATCHRESULT non restituiscono dati.
Vengono stabiliti i nuovi modelli di parole chiave e il rilevatore di parole chiave opera sui nuovi modelli.

Il driver può mantenere la richiesta in sospeso fino a quando non vengono soddisfatte le condizioni precedenti. Inoltre, se il dispositivo richiede un tempo di inizializzazione misurabile, il driver può mantenere questa richiesta in sospeso fino a quando il dispositivo non è pronto e può elaborare la richiesta.

Il sistema operativo richiede questo comportamento per evitare race condition tra una parola chiave rilevata e l'aggiornamento dei modelli di parole chiave (ad esempio, se è stata rilevata una parola chiave e il KSEVENT_SOUNDDETECTOR generato un istante prima che il sistema operativo aggiorni le parole chiave).

Il sistema operativo attende almeno 2 secondi per il completamento della richiesta.