Freigeben über

KSPROPSETID_SoundDetector2

  • Artikel

Der KSPROPSETID_SoundDetector2 Eigenschaftensatz enthält Eigenschaften, die zum Registrieren eines Filters für ein Audioaufnahmegerät verwendet werden, das auch eine Erkennung unterstützt. Der Filter verfügt über eine KS-Pinfactory, die über KSNODETYPE_AUDIO_KEYWORDDETECTOR pin category verfügt. Es darf nicht mehr als eine Pinfactory mit dieser KS-Pinkategorie in einem bestimmten KS-Filter instance.

KSPROPSETID_SoundDetector2wird in Windows 10 Version 1903 und höher unterstützt. Der KSPROPSETID_SoundDetector2-Eigenschaftssatz wird verwendet, um mehrere Sprach-Agents zu unterstützen. Weitere Informationen finden Sie unter Assistent für mehrere Spracheingaben. KSPROPSETID_SoundDetector Eigenschaftensatz wird auf Systemen verwendet, die nur Cortana unterstützen.

KSPROPSETID_SoundDetector2 verwendet die KSSOUNDDETECTORPROPERTY-Struktur anstelle einer KSPROPERTY:

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

Alle KSPROPSETID_SoundDetector2 Eigenschaften werden mit einer KSSOUNDDETECTORPROPERTY-Datenstruktur aufgerufen. Diese Datenstruktur enthält eine KSPROPERTY und die Ereignis-ID für die Schlüsselwort (keyword), die bewaffnet, zurückgesetzt, erkannt usw. werden soll.

Die Headerdatei definiert die KSPROPSETID_SoundDetector2-Eigenschaft wie folgt:

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

Der KSPROPSETID_SoundDetector2 Eigenschaftensatz enthält die folgenden Eigenschaften:

  • KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS : Diese Eigenschaft wird vom Betriebssystem festgelegt, um die zu erkennenden Schlüsselwörter zu konfigurieren.

  • KSPROPERTY_SOUNDDETECTOR_PATTERNS : Der KS-Filter des Treibers unterstützt diese Lese-/Schreibeigenschaft. Das Betriebssystem legt diese Eigenschaft fest, um die zu erkennenden Schlüsselwörter zu konfigurieren.

  • KSPROPERTY_SOUNDDETECTOR_ARMED: Diese Lese-/Schreibeigenschaft ist ein einfach boolescher status, der angibt, ob der Detektor bewaffnet ist. Das Betriebssystem legt dies so fest, dass die Schlüsselwort (keyword)-Erkennung verwendet wird. Das Betriebssystem kann dies löschen, um sich zu trennen. Der Treiber löscht dies automatisch, wenn Schlüsselwort (keyword) Muster festgelegt sind und auch, nachdem ein Schlüsselwort (keyword) erkannt wurde. (Das Betriebssystem muss neu erstellt werden.)

  • KSPROPERTY_SOUNDDETECTOR_RESET : Setzen Sie die Erkennung auf einen unbewaffneten Zustand zurück, ohne dass das Muster festgelegt ist.

  • KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT : Zukünftige Verwendung nur für Spracherkennungserkennungen. Schlägt diese Anforderung fehl, wodurch die Eigenschaft nicht unterstützt wird oder erfolgreich ist, und gibt true für alle anderen Treiber zurück.

Zum Zeitpunkt Schlüsselwort (keyword) Erkennung wird eine PNP-Benachrichtigung mit KSNOTIFICATIONID_SoundDetector gesendet. HINWEIS: Dies ist kein KSEvent, sondern ein PNP-Ereignis, das über IoReportTargetDeviceChangeAsynchronous mit einer Nutzlast gesendet wird.