structure _BRB_SCO_GET_CHANNEL_INFO (bthddi.h)

Article
02/06/2025

La structure _BRB_SCO_GET_CHANNEL_INFO décrit les paramètres et les statistiques d’un canal SCO.

Syntaxe

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;
};

Membres

Hdr

Structure BRB_HEADER qui contient des informations sur le BRB actuel.

BtAddress

Adresse Bluetooth de l’appareil distant.

ChannelHandle

Handle vers le canal SCO à interroger.

InfoFlags

Indicateur qui détermine si les informations de bande de base sont disponibles pour le canal SCO. L’indicateur suivant est défini :

Drapeau	Description
SCO_INFO_BASEBAND_AVAILABLE	Si cette option est définie, les paramètres de bande de base sont disponibles pour le canal SCO.

TransmitBandwidth

Bande passante de transmission du canal, en octets par seconde.

ReceiveBandwidth

Bande passante de réception du canal, en octets par seconde.

MaxLatency

Valeur qui représente la limite supérieure de la somme de l’intervalle synchrone et de la taille de la fenêtre SCO, en millisecondes. Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeurs	Description
0x0000 à 0x0003	Réservé pour une utilisation ultérieure.
0x0004 à 0xFFFE	Plage de valeurs de latence pour le canal.
0xFFFF	Le canal n’a pas de paramètre de MaxLatency préféré.

PacketType

Indicateur ou combinaison d’indicateurs qui indique le type de paquets de données pris en charge par le canal SCO. Ces types de paquets SCO sont définis par bluetooth SIG. Pour plus d’informations sur ces indicateurs, consultez la spécification Bluetooth. Les valeurs possibles sont les suivantes :

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

Paramètre vocal audio pour le canal. Utilisez les définitions suivantes pour décoder ce membre :

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

Réservé pour une utilisation ultérieure. N’utilisez pas.

RetransmissionEffort

Valeur SCO_RETRANSMISSION_EFFORT qui détermine les stratégies de retransmission du canal.

ChannelFlags

Indicateurs qui spécifient la façon dont le canal a été ouvert. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant.

Drapeau	Description
SCO_CF_LINK_AUTHENTICATED	Le lien doit être authentifié.
SCO_CF_LINK_ENCRYPTED	Le lien doit être chiffré. La définition de cet indicateur définit également l’indicateur de SCO_CF_LINK_AUTHENTICATED.
SCO_CF_LINK_SUPPRESS_PIN	Le pilote de profil indique sa préférence que les utilisateurs ne sont pas invités à entrer un code confidentiel.

HciConnectionHandle

Handle de connexion de l’interface du contrôleur hôte pour la connexion SCO.

LinkType

Le SCO_LINK_TYPE associé à l’interface du contrôleur hôte.

BasebandInfo

Structure BASEBAND_CHANNEL_INFO qui contient des informations pour la connexion SCO. Ces informations sont disponibles uniquement pour les liens établis à l’aide des commandes synchrones Bluetooth 1.2.