IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artigo
06/02/2025

O IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL obtém uma atualização de status de conexão.

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 BOOL que é o novo status da conexão. TRUE se conectado. FALSE se não estiver conectado.

Comprimento do buffer de saída

O tamanho de um BOOL.

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 da conexão tiver sido alterado desde a última solicitação. Caso contrário, essa solicitação permanecerá pendente até que o status da conexão seja alterado ou a solicitação seja cancelada.

O driver de áudio envia essa solicitação para obter o status de conexão inicial e envia solicitações subsequentes para serem atualizadas quando o status for alterado. O driver armazena o status da conexão em dados de contexto apropriados.

Quando a solicitação é concluída e indica uma alteração no status da conexão, o driver de áudio gera o evento KS KSEVENT_PINCAPS_JACKINFOCHANGE.

Ao lidar com a propriedade KSPROPERTY_JACK_DESCRIPTION KS, o driver de áudio define o membro isConnected da estrutura KSJACK_DESCRIPTION com base no status da conexão.