IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL (bthhfpddi.h)

Artigo
02/22/2024

O IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE IOCTL obtém uma conexão status atualizaçã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-o como FALSE.

Comprimento do buffer de entrada

O tamanho de um BOOL.

Buffer de saída

Um BOOL que é o novo status de 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.

Comentários

Essa solicitação será concluída imediatamente se o parâmetro de entrada for TRUE ou se a conexão status tiver sido alterada desde a última solicitação. Caso contrário, essa solicitação permanecerá pendente até que a conexão status seja alterada 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 a serem atualizadas quando o status é alterado. O driver armazena o status de conexão em dados de contexto apropriados.

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

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