_BRB_SCO_GET_CHANNEL_INFO - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// bthddi.h
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;
};
View the official Windows Driver Kit DDI referenceNo description available.
The _BRB_SCO_GET_CHANNEL_INFO structure describes the settings and statistics of a SCO channel.
HdrA BRB_HEADER structure that contains information about the current BRB.
BtAddressThe Bluetooth address of the remote device.
ChannelHandleThe handle to the SCO channel to query.
InfoFlagsA flag that determines if baseband information is available for the SCO channel. The following flag is defined:
| Flag | Description |
|---|---|
| SCO_INFO_BASEBAND_AVAILABLE | If set, baseband settings are available for the SCO channel. |
TransmitBandwidthThe transmission bandwidth of the channel, in bytes per second.
ReceiveBandwidthThe reception bandwidth of the channel, in bytes per second.
MaxLatencyA value that represents the upper limit of the sum of the synchronous interval and the size of the SCO window, in milliseconds. Possible values are listed in the following table.
| Values | Description |
|---|---|
| 0x0000 to 0x0003 | Reserved for future use. |
| 0x0004 to 0xFFFE | The range of latency values for the channel. |
| 0xFFFF | The channel doesn't have a preferred MaxLatency setting. |
PacketTypeA flag or combination of flags that indicates the type of data packets that the SCO channel supports. These SCO packet types are defined by the Bluetooth SIG. See the Bluetooth specification for more information about these flags. Possible values include:
SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5
ContentFormatThe audio voice setting for the channel. Use the following definitions to decode this member:
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
ReservedReserved for future use. Do not use.
RetransmissionEffortA SCO_RETRANSMISSION_EFFORT value that determines the channel's retransmission policies.
ChannelFlagsFlags that specify how the channel was opened. Valid flag values are listed in the following table.
| Flag | Description |
|---|---|
| SCO_CF_LINK_AUTHENTICATED | The link must be authenticated. |
| SCO_CF_LINK_ENCRYPTED | The link must be encrypted. Setting this flag also sets the SCO_CF_LINK_AUTHENTICATED flag. |
| SCO_CF_LINK_SUPPRESS_PIN | The profile driver indicates its preference that users not be prompted for a PIN. |
HciConnectionHandleThe host controller interface's connection handle for the SCO connection.
LinkTypeThe SCO_LINK_TYPE that is associated with the host controller interface.
BasebandInfoA BASEBAND_CHANNEL_INFO structure that contains information for the SCO connection. This information is only available for links established using the 1.2 Bluetooth Synchronous Commands.
To get the settings and statistics of a SCO channel, profile drivers should build and send a BRB_SCO_GET_CHANNEL_INFO request.