estrutura _BRB_L2CA_UPDATE_CHANNEL (bthddi.h)

Artigo
02/26/2024

A estrutura _BRB_L2CA_UPDATE_CHANNEL descreve uma atualização para as características de link 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 membro NewChannelFlags que a pilha de driver Bluetooth não foi capaz de honrar. Esse membro contém informações somente se a chamada BRB falhou.

Comentários

Para recuperar as configurações atuais de um canal L2CAP, os drivers de perfil devem criar 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 principal uso 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 a 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 de BRB_L2CA_UPDATE_CHANNEL , os drivers de perfil podem evitar usar a conexão antes da autenticação.