struttura _BRB_SCO_GET_CHANNEL_INFO (bthddi.h)

Articolo
02/06/2025

La struttura _BRB_SCO_GET_CHANNEL_INFO descrive le impostazioni e le statistiche di un canale SCO.

Sintassi

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

Membri

Hdr

Struttura BRB_HEADER che contiene informazioni sull'oggetto BRB corrente.

BtAddress

Indirizzo Bluetooth del dispositivo remoto.

ChannelHandle

Handle per il canale SCO su cui eseguire una query.

InfoFlags

Flag che determina se le informazioni sulla banda di base sono disponibili per il canale SCO. Viene definito il flag seguente:

Bandiera	Descrizione
SCO_INFO_BASEBAND_AVAILABLE	Se impostata, le impostazioni della banda base sono disponibili per il canale SCO.

TransmitBandwidth

Larghezza di banda di trasmissione del canale, in byte al secondo.

ReceiveBandwidth

Larghezza di banda di ricezione del canale, in byte al secondo.

MaxLatency

Valore che rappresenta il limite superiore della somma dell'intervallo sincrono e delle dimensioni della finestra sco, in millisecondi. I valori possibili sono elencati nella tabella seguente.

Valori	Descrizione
0x0000 a 0x0003	Riservato per uso futuro.
0x0004 a 0xFFFE	Intervallo di valori di latenza per il canale.
0xFFFF	Il canale non ha un'impostazione di MaxLatency preferita.

PacketType

Flag o combinazione di flag che indica il tipo di pacchetti di dati supportati dal canale SCO. Questi tipi di pacchetti SCO sono definiti dal sig Bluetooth. Per altre informazioni su questi flag, vedere la specifica Bluetooth. I valori possibili includono:

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

Impostazione della voce audio per il canale. Usare le definizioni seguenti per decodificare questo 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

Riservato per uso futuro. Non usare.

RetransmissionEffort

Valore SCO_RETRANSMISSION_EFFORT che determina i criteri di ritrasmissione del canale.

ChannelFlags

Flag che specificano la modalità di apertura del canale. I valori di flag validi sono elencati nella tabella seguente.

Bandiera	Descrizione
SCO_CF_LINK_AUTHENTICATED	Il collegamento deve essere autenticato.
SCO_CF_LINK_ENCRYPTED	Il collegamento deve essere crittografato. L'impostazione di questo flag imposta anche il flag di SCO_CF_LINK_AUTHENTICATED.
SCO_CF_LINK_SUPPRESS_PIN	Il driver del profilo indica la preferenza che gli utenti non devono essere richiesti per un PIN.

HciConnectionHandle

Handle di connessione dell'interfaccia del controller host per la connessione SCO.

LinkType

Il SCO_LINK_TYPE associato all'interfaccia del controller host.

BasebandInfo

Struttura BASEBAND_CHANNEL_INFO che contiene informazioni per la connessione SCO. Queste informazioni sono disponibili solo per i collegamenti stabiliti usando i comandi sincroni bluetooth 1.2.