estructura de _BRB_SCO_GET_CHANNEL_INFO (bthddi.h)

Artículo
03/08/2023

La estructura _BRB_SCO_GET_CHANNEL_INFO describe la configuración y las estadísticas de un canal SCO.

Sintaxis

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

Miembros

Hdr

Estructura BRB_HEADER que contiene información sobre el BRB actual.

BtAddress

La dirección Bluetooth del dispositivo remoto.

ChannelHandle

Identificador del canal SCO que se va a consultar.

InfoFlags

Marca que determina si la información de banda base está disponible para el canal SCO. Se define la marca siguiente:

Marca	Descripción
SCO_INFO_BASEBAND_AVAILABLE	Si se establece, la configuración de banda base está disponible para el canal SCO.

TransmitBandwidth

Ancho de banda de transmisión del canal, en bytes por segundo.

ReceiveBandwidth

Ancho de banda de recepción del canal, en bytes por segundo.

MaxLatency

Valor que representa el límite superior de la suma del intervalo sincrónico y el tamaño de la ventana SCO, en milisegundos. Los valores posibles se enumeran en la tabla siguiente.

Valores	Descripción
0x0000 a 0x0003	Reservado para uso futuro.
0x0004 a 0xFFFE	Intervalo de valores de latencia para el canal.
0xFFFF	El canal no tiene una configuración de MaxLatency preferida.

PacketType

Marca o combinación de marcas que indica el tipo de paquetes de datos que admite el canal SCO. Estos tipos de paquetes SCO se definen mediante bluetooth SIG. Consulta la especificación bluetooth para obtener más información sobre estas marcas. Los valores posibles son:

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

Configuración de voz de audio para el canal. Use las definiciones siguientes para descodificar este miembro:

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. No debe usarse.

RetransmissionEffort

Valor de SCO_RETRANSMISSION_EFFORT que determina las directivas de retransmisión del canal.

ChannelFlags

Marcas que especifican cómo se abrió el canal. Los valores de marca válidos se muestran en la tabla siguiente.

Marca	Descripción
SCO_CF_LINK_AUTHENTICATED	El vínculo debe autenticarse.
SCO_CF_LINK_ENCRYPTED	El vínculo debe cifrarse. Al establecer esta marca también se establece la marca SCO_CF_LINK_AUTHENTICATED.
SCO_CF_LINK_SUPPRESS_PIN	El controlador de perfil indica su preferencia de que no se pida a los usuarios un PIN.

HciConnectionHandle

Identificador de conexión de la interfaz del controlador de host para la conexión SCO.

LinkType

El SCO_LINK_TYPE asociado a la interfaz del controlador de host.

BasebandInfo

Estructura BASEBAND_CHANNEL_INFO que contiene información para la conexión SCO. Esta información solo está disponible para los vínculos establecidos mediante los comandos sincrónicos bluetooth 1.2.

Comentarios

Para obtener la configuración y las estadísticas de un canal SCO, los controladores de perfil deben compilar y enviar un BRB_SCO_GET_CHANNEL_INFO solicitud.