IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artigo
02/22/2024

O IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE IOCTL Obtém a configuração de nível de volume do microfone 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 microfone 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.

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 iniciais de volume do alto-falante e do 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 caminho do microfone.

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