Compartilhar via


IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL (bthhfpddi.h)

O IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL Obtém a configuração de nível de volume do alto-falante do dispositivo Bluetooth.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um BOOL definido como TRUE para solicitar uma atualização imediata. Caso contrário, defina-o como FALSE.

Comprimento do buffer de entrada

O tamanho de um BOOL.

Buffer de saída

Um LONG que representa o nível de volume do alto-falante em decibéis 1/65536.

Comprimento do buffer de saída

O tamanho de um LONG.

Bloco de status

Se uma solicitação já estiver pendente, a nova solicitação falhará e uma mensagem STATUS_INVALID_DEVICE_REQUEST será retornada.

Comentários

Essa solicitação será concluída imediatamente se o parâmetro de entrada for TRUE ou se o volume status tiver sido alterado desde a última solicitação. Caso contrário, essa solicitação permanecerá pendente até que o volume status seja alterado ou a solicitação seja cancelada.

O driver de áudio envia essa solicitação para obter os níveis de volume inicial do alto-falante e do microfone e envia solicitações subsequentes "pedindo" para serem atualizadas quando os níveis forem alterados. O driver armazena os níveis de volume em dados de contexto apropriados. Quando o nível de volume é alterado, o driver de áudio gera o evento KSEVENT_CONTROL_CHANGE para o nó KSNODETYPE_VOLUME na topologia KS do alto-falante ou do caminho do microfone.

O parâmetro de saída da solicitação é o mesmo que o valor da propriedade KSPROPERTY_AUDIO_VOLUMELEVEL .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Cabeçalho bthhfpddi.h

Confira também

IOCLs DDI do BLUETOOTH HFP

KSEVENT_CONTROL_CHANGE

KSNODETYPE_VOLUME

KSPROPERTY_AUDIO_VOLUMELEVEL