KSPROPERTY_SOUNDDETECTOR_PATTERNS

Artikel
06/14/2023

Die KSPROPERTY_SOUNDDETECTOR_PATTERNS-Eigenschaft wird vom Betriebssystem festgelegt, um die zu erkennenden Schlüsselwörter zu konfigurieren.

Das Betriebssystem legt die Schlüsselwort (keyword) Muster fest oder legt dies möglicherweise auf einen leeren Wert fest.

Wenn das Betriebssystem diese Eigenschaft festlegt, entwaffnet der Treiber den Detektor automatisch, wenn er zuvor bewaffnet war.

Wenn der Treiber eine "set"-Anforderung aufgrund unzureichender Ressourcen nicht erfüllen kann, schlägt der Treiber die Anforderung mit STATUS_INSUFFICIENT_RESOURCES fehl.

Nutzungszusammenfassungstabelle – KSPROPSETID_SoundDetector

In dieser Verwendungstabelle wird zusammengefasst, wann KSPROPERTY_SOUNDDETECTOR_ARMED mit KSPROPSETID_SoundDetector aufgerufen wird .

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Nein	Ja	Filter	KSPROPERTY	KSMULTIPLE_ITEM

Nutzungszusammenfassungstabelle – KSPROPSETID_SoundDetector2

In dieser Verwendungstabelle wird zusammengefasst, wann KSPROPERTY_SOUNDDETECTOR_ARMED mit KSPROPSETID_SoundDetector2 aufgerufen wird

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Nein	Ja	Filter	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

Rückgabewert

Der Eigenschaftswert ist eine KSMULTIPLE_ITEM-Struktur gefolgt von einer Sequenz von 64-Bit-orientierten Erkennungsmustern. Jedes Muster beginnt mit einem SOUNDDETECTOR_PATTERNHEADER gefolgt von der Musternutzlast.

Bemerkungen

Der Fahrer darf die Anforderung "set" erst ausführen, wenn:

Der Detektor wird entwaffnet, und nachfolgende "get"-Anforderungen auf KSPROPERTY_SOUNDDETECTOR_ARMED false zurückgeben.
Nachfolgende "Get"-Anforderungen auf KSPROPERTY_SOUNDDETECTOR_MATCHRESULT keine Daten zurückgeben.
Die neuen Schlüsselwort (keyword) Muster werden etabliert, und der Schlüsselwort (keyword) Detektor arbeitet nach den neuen Mustern.

Der Fahrer kann die Anforderung solange ausstehen lassen, bis die oben genannten Bedingungen erfüllt sind. Wenn das Gerät eine messbare Initialisierungszeit benötigt, kann der Treiber diese Anforderung möglicherweise ausstehen lassen, bis das Gerät bereit ist und die Anforderung verarbeiten kann.

Das Betriebssystem erfordert dieses Verhalten, um Racebedingungen zwischen einem erkannten Schlüsselwort (keyword) und dem Aktualisieren Schlüsselwort (keyword) Musters zu vermeiden (z. B. wenn ein Schlüsselwort (keyword) erkannt wurde und das KSEVENT_SOUNDDETECTOR einen Augenblick generiert hat, bevor das Betriebssystem die Schlüsselwörter aktualisiert).

Das Betriebssystem wartet mindestens 2 Sekunden, bis diese Anforderung abgeschlossen ist.