KSPROPSETID_SoundDetector2

O KSPROPSETID_SoundDetector2 conjunto de propriedades contém propriedades que são usadas para registrar um filtro para um dispositivo de captura de áudio que também dá suporte a um detector. O filtro tem uma fábrica de pinos KS que tem KSNODETYPE_AUDIO_KEYWORDDETECTOR de categoria de pino. Não pode haver mais de uma fábrica de pinos com essa categoria de pino KS em uma determinada instância de filtro KS.

KSPROPSETID_SoundDetector2há suporte no Windows 10 versão 1903 e posterior. O conjunto de propriedades KSPROPSETID_SoundDetector2 é usado para dar suporte a vários agentes de voz. Para obter mais informações, consulte Assistente de Várias Vozes. KSPROPSETID_SoundDetector conjunto de propriedades é usado em sistemas que dão suporte apenas à Cortana.

KSPROPSETID_SoundDetector2 usa a estrutura KSSOUNDDETECTORPROPERTY , em vez de uma KSPROPERTY:

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

Todas as propriedades KSPROPSETID_SoundDetector2 são chamadas com uma estrutura de dados KSSOUNDDETECTORPROPERTY . Essa estrutura de dados contém um KSPROPERTY e a ID do evento para que o palavra-chave esteja armado, redefinido, detectado etc.

O arquivo de cabeçalho define o conjunto de propriedades KSPROPSETID_SoundDetector2 da seguinte maneira:

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

O KSPROPSETID_SoundDetector2 conjunto de propriedades contém as seguintes propriedades:

• KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS - Essa propriedade é definida pelo sistema operacional para configurar as palavras-chave a serem detectadas.

• KSPROPERTY_SOUNDDETECTOR_PATTERNS - O filtro KS do driver dá suporte a essa propriedade de leitura/gravação. O sistema operacional define essa propriedade para configurar as palavras-chave a serem detectadas.

• KSPROPERTY_SOUNDDETECTOR_ARMED - Essa propriedade de leitura/gravação é uma status booliana que indica se o detector está armado. O sistema operacional define isso para envolver o detector de palavra-chave. O sistema operacional pode limpar isso para desengajar. O driver limpa isso automaticamente quando palavra-chave padrões são definidos e também depois que um palavra-chave é detectado. (O sistema operacional deve ser rearm.)

• KSPROPERTY_SOUNDDETECTOR_RESET - Redefina o detector para um estado desarmado sem nenhum padrão definido.

• KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT - Uso futuro somente para detectores de conjunto de voz. Falha nesta solicitação indicando que a propriedade não tem suporte ou é bem-sucedida e retorna true para todos os outros drivers.

No momento palavra-chave detecção, uma notificação PNP que contém KSNOTIFICATIONID_SoundDetector é enviada. OBSERVAÇÃO: este não é um KSEvent, mas sim um evento PNP que é enviado, com uma carga, por meio de IoReportTargetDeviceChangeAsynchronous.