_BRB_SCO_GET_CHANNEL_INFO 結構 (bthddi.h)

發行項
02/22/2024

_BRB_SCO_GET_CHANNEL_INFO 結構描述 SCO 通道的設定和統計數據。

語法

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

成員

Hdr

包含目前 BRB 相關信息的BRB_HEADER 結構。

BtAddress

遠端裝置的藍牙位址。

ChannelHandle

要查詢之 SCO 通道的句柄。

InfoFlags

旗標，決定 SCO 通道是否提供基底帶資訊。定義下列旗標：

旗標	描述
SCO_INFO_BASEBAND_AVAILABLE	如果設定，則適用於 SCO 通道的基底帶設定。

TransmitBandwidth

通道的傳輸頻寬，每秒以位元組為單位。

ReceiveBandwidth

通道的接收頻寬，每秒以位元組為單位。

MaxLatency

值，表示同步間隔和 SCO 視窗大小的總和上限，以毫秒為單位。下表列出可能的值。

值	Description
0x0000 0x0003	保留供未來使用。
要0xFFFE的0x0004	通道的延遲值範圍。
0xFFFF	通道沒有慣用的 MaxLatency 設定。

PacketType

旗標或旗標的組合，表示 SCO 通道所支援的數據封包類型。這些 SCO 封包類型是由藍牙 SIG 所定義。如需這些旗標的詳細資訊，請參閱藍牙規格。可能的值包括：

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

通道的音訊語音設定。使用下列定義來譯碼此成員：

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

保留供未來使用。請勿使用。

RetransmissionEffort

決定通道重新傳輸原則的SCO_RETRANSMISSION_EFFORT 值。

ChannelFlags

指定通道開啟方式的旗標。下表列出有效的旗標值。

旗標	描述
SCO_CF_LINK_AUTHENTICATED	必須驗證連結。
SCO_CF_LINK_ENCRYPTED	鏈接必須經過加密。設定此旗標也會設定SCO_CF_LINK_AUTHENTICATED旗標。
SCO_CF_LINK_SUPPRESS_PIN	配置文件驅動程式指出其喜好設定，指出使用者未提示輸入 PIN。