_BRB_SCO_GET_CHANNEL_INFO-Struktur (bthddi.h)

Artikel
02/22/2024

Die _BRB_SCO_GET_CHANNEL_INFO-Struktur beschreibt die Einstellungen und Statistiken eines SCO-Kanals.

Syntax

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

Member

Hdr

Eine BRB_HEADER-Struktur , die Informationen zum aktuellen BRB enthält.

BtAddress

Die Bluetooth-Adresse des Remotegeräts.

ChannelHandle

Das Handle für den abzufragenden SCO-Kanal.

InfoFlags

Ein Flag, das bestimmt, ob Basisbandinformationen für den SCO-Kanal verfügbar sind. Das folgende Flag ist definiert:

Flag	Beschreibung
SCO_INFO_BASEBAND_AVAILABLE	Wenn festgelegt, sind baseband-Einstellungen für den SCO-Kanal verfügbar.

TransmitBandwidth

Die Übertragungsbandbreite des Kanals in Bytes pro Sekunde.

ReceiveBandwidth

Die Empfangsbandbreite des Kanals in Bytes pro Sekunde.

MaxLatency

Ein -Wert, der die Obergrenze der Summe des synchronen Intervalls und die Größe des SCO-Fensters in Millisekunden darstellt. Mögliche Werte sind in der folgenden Tabelle aufgeführt.

Werte	BESCHREIBUNG
0x0000 zu 0x0003	Für die zukünftige Verwendung reserviert.
0x0004 zu 0xFFFE	Der Bereich der Latenzwerte für den Kanal.
0xFFFF	Der Kanal verfügt nicht über eine bevorzugte MaxLatency-Einstellung .

PacketType

Ein Flag oder eine Kombination aus Flags, die den Typ der Datenpakete angibt, die vom SCO-Kanal unterstützt werden. Diese SCO-Pakettypen werden von der Bluetooth-SIG definiert. Weitere Informationen zu diesen Flags finden Sie in der Bluetooth-Spezifikation. Mögliche Werte sind:

SCO_HV1
SCO_HV2
SCO_HV3
SCO_EV3
SCO_EV4
SCO_EV5

ContentFormat

Die Audiostimme-Einstellung für den Kanal. Verwenden Sie die folgenden Definitionen, um diesen Member zu decodieren:

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

Für die zukünftige Verwendung reserviert. Nicht verwenden.

RetransmissionEffort

Ein SCO_RETRANSMISSION_EFFORT Wert, der die Richtlinien für die erneute Übertragung des Kanals bestimmt.

ChannelFlags

Flags, die angeben, wie der Kanal geöffnet wurde. Gültige Flagwerte sind in der folgenden Tabelle aufgeführt.

Flag	Beschreibung
SCO_CF_LINK_AUTHENTICATED	Der Link muss authentifiziert werden.
SCO_CF_LINK_ENCRYPTED	Der Link muss verschlüsselt sein. Durch Festlegen dieses Flags wird auch das SCO_CF_LINK_AUTHENTICATED-Flag festgelegt.
SCO_CF_LINK_SUPPRESS_PIN	Der Profiltreiber gibt an, dass Benutzer nicht zur Eingabe einer PIN aufgefordert werden.

HciConnectionHandle

Das Verbindungshandle der Hostcontrollerschnittstelle für die SCO-Verbindung.

LinkType

Die SCO_LINK_TYPE , die der Hostcontrollerschnittstelle zugeordnet ist.

BasebandInfo

Eine BASEBAND_CHANNEL_INFO-Struktur , die Informationen für die SCO-Verbindung enthält. Diese Informationen sind nur für Links verfügbar, die mit den synchronen Bluetooth-Befehlen 1.2 erstellt wurden.

Hinweise

Um die Einstellungen und Statistiken eines SCO-Kanals abzurufen, sollten Profiltreiber eine erstellen und senden . BRB_SCO_GET_CHANNEL_INFO Anforderung.