KSPROPERTY_SOUNDDETECTOR_PATTERNS

Artigo
06/14/2023

A propriedade KSPROPERTY_SOUNDDETECTOR_PATTERNS é definida pelo sistema operacional para configurar as palavras-chave a serem detectadas.

O sistema operacional define os padrões de palavra-chave ou pode definir isso como um valor vazio.

Quando o sistema operacional define essa propriedade, o motorista desarma automaticamente o detector se estiver armado anteriormente.

Se o driver não puder atender a uma solicitação "definida" devido a recursos insuficientes, o driver falhará na solicitação com STATUS_INSUFFICIENT_RESOURCES.

Tabela de Resumo de Uso – KSPROPSETID_SoundDetector

Essa tabela de uso resume quando KSPROPERTY_SOUNDDETECTOR_ARMED é chamado com KSPROPSETID_SoundDetector

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Não	Sim	Filtrar	KSPROPERTY	KSMULTIPLE_ITEM

Tabela de Resumo de Uso – KSPROPSETID_SoundDetector2

Essa tabela de uso resume quando KSPROPERTY_SOUNDDETECTOR_ARMED é chamado com KSPROPSETID_SoundDetector2

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Não	Sim	Filtrar	KSSOUNDDETECTORPROPERTY	KSMULTIPLE_ITEM

Valor retornado

O valor da propriedade é uma estrutura KSMULTIPLE_ITEM seguida por uma sequência de padrões de detecção alinhados de 64 bits. Cada padrão começa com um SOUNDDETECTOR_PATTERNHEADER seguido pelo conteúdo padrão.

Comentários

O driver não deve concluir a solicitação "set" até:

O detector é desarmado e as solicitações subsequentes de "obter" em KSPROPERTY_SOUNDDETECTOR_ARMED retornam false.
As solicitações "get" subsequentes em KSPROPERTY_SOUNDDETECTOR_MATCHRESULT não retornam dados.
Os novos padrões de palavra-chave são estabelecidos e o detector de palavra-chave está operando nos novos padrões.

O driver pode manter a solicitação pendente até que as condições acima sejam atendidas. Além disso, se o dispositivo exigir um tempo de inicialização mensurável, o driver poderá manter essa solicitação pendente até que o dispositivo esteja pronto e o possa processar a solicitação.

O sistema operacional requer esse comportamento para evitar condições de corrida entre um detectado um palavra-chave e a atualização de padrões de palavra-chave (por exemplo, se um palavra-chave foi detectado e o KSEVENT_SOUNDDETECTOR gerado um instante antes de o sistema operacional atualizar as palavras-chave).

O sistema operacional aguarda pelo menos 2 segundos para que essa solicitação seja concluída.