Partilhar 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 isso 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 de 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.

Observações

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

O driver de áudio envia essa solicitação para obter os níveis iniciais de volume de alto-falante e microfone e envia solicitações subsequentes "solicitando" que sejam 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
de cliente com suporte mínimo Windows 8
servidor com suporte mínimo Windows Server 2012
cabeçalho bthhfpddi.h

Consulte também

IOCTLs de DDI do HFP Bluetooth

KSEVENT_CONTROL_CHANGE

KSNODETYPE_VOLUME

KSPROPERTY_AUDIO_VOLUMELEVEL