KSPROPSETID_SoundDetector2

  • Articolo

Il KSPROPSETID_SoundDetector2 set di proprietà contiene proprietà utilizzate per registrare un filtro per un dispositivo di acquisizione audio che supporta anche un rilevatore. Il filtro ha una factory di pin KS con categoria pin KSNODETYPE_AUDIO_KEYWORDDETECTOR. Non possono essere presenti più pin factory con questa categoria di pin KS in una determinata istanza del filtro KS.

KSPROPSETID_SoundDetector2è supportato in Windows 10 versione 1903 e successive. Il set di proprietà KSPROPSETID_SoundDetector2 viene usato per supportare più agenti vocali. Per altre informazioni, vedere Assistente vocale multiplo. KSPROPSETID_SoundDetector set di proprietà viene usato nei sistemi che supportano solo Cortana.

KSPROPSETID_SoundDetector2 utilizza la struttura KSSOUNDDETECTORPROPERTY , anziché KSPROPERTY:

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

Tutte le proprietà KSPROPSETID_SoundDetector2 vengono chiamate con una struttura di dati KSSOUNDDETECTORPROPERTY . Questa struttura di dati contiene un KSPROPERTY e l'ID evento per la parola chiave da armare, reimpostare, rilevare e così via.

Il file di intestazione definisce il set di proprietà KSPROPSETID_SoundDetector2 come indicato di seguito:

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

Il KSPROPSETID_SoundDetector2 set di proprietà contiene le proprietà seguenti:

  • KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS : questa proprietà viene impostata dal sistema operativo per configurare le parole chiave da rilevare.

  • KSPROPERTY_SOUNDDETECTOR_PATTERNS : il filtro KS del driver supporta questa proprietà di lettura/scrittura. Il sistema operativo imposta questa proprietà per configurare le parole chiave da rilevare.

  • KSPROPERTY_SOUNDDETECTOR_ARMED : questa proprietà di lettura/scrittura è semplicemente uno stato booleano che indica se il rilevatore è armato. Il sistema operativo imposta questo valore per coinvolgere il rilevatore di parole chiave. Il sistema operativo può cancellare questa operazione per disattivare. Il driver cancella automaticamente questo valore quando vengono impostati i criteri di parola chiave e anche dopo il rilevamento di una parola chiave. Il sistema operativo deve riprovare.

  • KSPROPERTY_SOUNDDETECTOR_RESET : reimpostare il rilevatore su uno stato non associato senza un set di criteri.

  • KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT - Uso futuro solo per i rilevatori di esordio vocale. Questa richiesta non riesce a indicare che la proprietà non è supportata o ha esito positivo e restituisce true per tutti gli altri driver.

Al momento del rilevamento delle parole chiave viene inviata una notifica PNP contenente KSNOTIFICATIONID_SoundDetector. NOTA: non si tratta di un evento KSEvent, ma piuttosto di un evento PNP che viene inviato, con un payload, tramite IoReportTargetDeviceChangeAsynchronous.