KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED é uma nova propriedade KS que foi adicionada à propriedade KSPROPSETID_Audio definida em Windows 8.1.

A solicitação de propriedade KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED passa a preferência de limite de nível de volume de um usuário final para o driver subjacente. O escopo dessa propriedade é por pino (ou por ponto de extremidade de áudio, do ponto de vista de um usuário final).

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Não	Sim	Fixar instância	KSP_PIN	BOOL

O valor da propriedade é do tipo BOOL e indica se um usuário final permite que o volume máximo esteja acima de um determinado limite. Um valor true indica que um usuário final permitiu que o nível de volume estivesse acima do limite postado, enquanto FALSE indica o oposto. No caso de uma conta filho, o valor sempre será FALSE.

O driver armazena o valor dessa propriedade em uma variável interna e inicializa o valor como TRUE durante a inicialização. Embora essa propriedade seja TRUE, o driver limita o nível máximo de volume. Quando a propriedade é definida como FALSE, o driver pode remover esses limites.

O driver também pode alterar o valor dessa propriedade automaticamente. Por exemplo, o driver pode alternar automaticamente o valor da propriedade de TRUE para FALSE e, em seguida, começar a limitar o nível de volume depois que algum tempo acima de determinados níveis de som tiver decorrido.

Sempre que o valor da propriedade for alterado, independentemente de ser automático ou devido a um chamador definir o valor da propriedade, o driver deve gerar o evento KSEVENT_PINCAPS_VOLUMELIMITCHANGE.

Valor retornado

A solicitação de propriedade KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED retorna STATUS_SUCCESS quando a solicitação é bem-sucedida.

Requisitos

Versão	Windows 8.1
Cabeçalho	Ksmedia.h (inclua Ksmedia.h)