estrutura _BRB_SCO_GET_CHANNEL_INFO (bthddi.h)

Artigo
02/22/2024

A estrutura _BRB_SCO_GET_CHANNEL_INFO descreve as configurações e estatísticas de um canal SCO.

Sintaxe

struct _BRB_SCO_GET_CHANNEL_INFO {
  BRB_HEADER                Hdr;
  BTH_ADDR                  BtAddress;
  SCO_CHANNEL_HANDLE        ChannelHandle;
  ULONG                     InfoFlags;
  ULONG                     TransmitBandwidth;
  ULONG                     ReceiveBandwidth;
  USHORT                    MaxLatency;
  USHORT                    PacketType;
  USHORT                    ContentFormat;
  USHORT                    Reserved;
  SCO_RETRANSMISSION_EFFORT RetransmissionEffort;
  ULONG                     ChannelFlags;
  CONNECTION_HANDLE         HciConnectionHandle;
  SCO_LINK_TYPE             LinkType;
  BASEBAND_CHANNEL_INFO     BasebandInfo;
};

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 para o canal SCO a ser consultado.

InfoFlags

Um sinalizador que determina se as informações de banda base estão disponíveis para o canal SCO. O seguinte sinalizador é definido:

Sinalizador	Descrição
SCO_INFO_BASEBAND_AVAILABLE	Se definido, as configurações de banda base estarão disponíveis para o canal SCO.

TransmitBandwidth

A largura de banda de transmissão do canal, em bytes por segundo.

ReceiveBandwidth

A largura de banda de recepção do canal, em bytes por segundo.

MaxLatency

Um valor que representa o limite superior da soma do intervalo síncrono e do tamanho da janela SCO, em milissegundos. Os valores possíveis são listados na tabela a seguir.

Valores	Descrição
0x0000 para 0x0003	Reservado para uso futuro.
0x0004 0xFFFE	O intervalo de valores de latência para o canal.
0xFFFF	O canal não tem uma configuração de MaxLatency preferencial.

PacketType

Um sinalizador ou combinação de sinalizadores que indica o tipo de pacotes de dados aos quais o canal SCO dá suporte. Esses tipos de pacote SCO são definidos pelo SIG bluetooth. Consulte a especificação bluetooth para obter mais informações sobre esses sinalizadores. Os valores possíveis incluem:

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

A configuração de voz de áudio para o canal. Use as seguintes definições para decodificar este membro:

SCO_VS_AIR_CODING_DATA
SCO_VS_AIR_CODING_FORMAT_ALAW
SCO_VS_AIR_CODING_FORMAT_CVSD
SCO_VS_AIR_CODING_FORMAT_MASK
SCO_VS_AIR_CODING_FORMAT_MULAW
SCO_VS_IN_CODING_ALAW
SCO_VS_IN_CODING_LINEAR
SCO_VS_IN_CODING_MASK
SCO_VS_IN_CODING_MULAW
SCO_VS_IN_DATA_FORMAT_1C
SCO_VS_IN_DATA_FORMAT_2C
SCO_VS_IN_DATA_FORMAT_MASK
SCO_VS_IN_DATA_FORMAT_SM
SCO_VS_IN_DATA_FORMAT_US
SCO_VS_IN_SAMPLE_SIZE_8BIT
SCO_VS_IN_SAMPLE_SIZE_16BIT
SCO_VS_IN_SAMPLE_SIZE_MASK
SCO_VS_PCM_BIT_POS_MASK
SCO_VS_SETTING_DEFAULT

Reserved

Reservado para uso futuro. Não use.

RetransmissionEffort

Um valor SCO_RETRANSMISSION_EFFORT que determina as políticas de retransmissão do canal.

ChannelFlags

Sinalizadores que especificam como o canal foi aberto. Os valores de sinalizador válidos são listados na tabela a seguir.

Sinalizador	Descrição
SCO_CF_LINK_AUTHENTICATED	O link deve ser autenticado.
SCO_CF_LINK_ENCRYPTED	O link deve ser criptografado. Definir esse sinalizador também define o sinalizador SCO_CF_LINK_AUTHENTICATED.
SCO_CF_LINK_SUPPRESS_PIN	O driver de perfil indica sua preferência de que os usuários não sejam solicitados a fornecer um PIN.

HciConnectionHandle

O identificador de conexão da interface do controlador de host para a conexão SCO.

LinkType

O SCO_LINK_TYPE associado à interface do controlador de host.

BasebandInfo

Uma estrutura BASEBAND_CHANNEL_INFO que contém informações para a conexão SCO. Essas informações só estão disponíveis para links estabelecidos usando os Comandos Síncronos Bluetooth 1.2.