estrutura _BRB_L2CA_UPDATE_CHANNEL (bthddi.h)

Artigo
02/06/2025

A estrutura _BRB_L2CA_UPDATE_CHANNEL descreve uma atualização para as características de vínculo de um canal L2CAP aberto para um dispositivo remoto ou para verificar quando determinados atributos de canal foram alterados.

Sintaxe

struct _BRB_L2CA_UPDATE_CHANNEL {
  BRB_HEADER           Hdr;
  BTH_ADDR             BtAddress;
  L2CAP_CHANNEL_HANDLE ChannelHandle;
  ULONG                NewChannelFlags;
  ULONG                FailedChannelFlags;
};

Membros

Hdr

Uma estrutura BRB_HEADER que contém informações sobre o BRB atual.

BtAddress

O endereço Bluetooth do dispositivo remoto.

ChannelHandle

O identificador de canal L2CAP que foi retornado pela pilha do driver Bluetooth em resposta a um BRB_L2CA_OPEN_CHANNEL anterior ou BRB_L2CA_OPEN_CHANNEL_RESPONSE solicitação.

NewChannelFlags

Uma combinação de valores de sinalizador que especificam os requisitos atualizados para o canal. Esse membro deve ser definido como CF_ROLE_EITHER.

FailedChannelFlags

O sinalizador ou sinalizadores no NewChannelFlags membro que a pilha de driver Bluetooth não foi capaz de honrar. Esse membro contém informações somente se a chamada brb falhou.

Observações

Para recuperar as configurações atuais de um canal L2CAP, os drivers de perfil devem compilar e enviar uma solicitação de BRB_L2CA_UPDATE_CHANNEL.

O driver de perfil pode determinar quando determinados atributos de canal foram alterados. Além disso, se o sinalizador CF_LINK_PASSIVE_MODE não estiver definido, o BRB tentará alterar as configurações atuais do canal para o dispositivo remoto.

O uso principal de BRB_L2CA_UPDATE_CHANNEL é determinar quando a autenticação ou criptografia foi habilitada para uma conexão.

Em alguns casos, as conexões L2CAP podem ser estabelecidas sem que o driver de perfil especifique que a autenticação é necessária, mas a autenticação ocorrerá automaticamente devido às escolhas feitas pelo usuário. Nesse caso, um período de tempo passa entre quando a conexão é estabelecida e quando a autenticação e a criptografia começam a funcionar. As chamadas para BRB_L2CA_UPDATE_CHANNEL são bloqueadas até que a autenticação e a criptografia sejam concluídas.

Ao criar e enviar uma solicitação BRB_L2CA_UPDATE_CHANNEL, os drivers de perfil podem evitar o uso da conexão antes da autenticação.