struttura _BRB_SCO_OPEN_CHANNEL (bthddi.h)

Articolo
02/22/2024

La struttura _BRB_SCO_OPEN_CHANNEL descrive un canale SCO da aprire a un dispositivo remoto o una risposta del driver del profilo che accetta o rifiuta una richiesta di connessione SCO in ingresso avviata da un dispositivo remoto.

Sintassi

struct _BRB_SCO_OPEN_CHANNEL {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      TransmitBandwidth;
  ULONG                      ReceiveBandwidth;
  USHORT                     MaxLatency;
  USHORT                     PacketType;
  USHORT                     ContentFormat;
  USHORT                     Reserved;
  SCO_RETRANSMISSION_EFFORT  RetransmissionEffort;
  ULONG                      ChannelFlags;
  ULONG                      CallbackFlags;
  PFNSCO_INDICATION_CALLBACK Callback;
  PVOID                      CallbackContext;
  PVOID                      ReferenceObject;
  SCO_CHANNEL_HANDLE         ChannelHandle;
  UCHAR                      Response;
};

Members

Hdr

Struttura BRB_HEADER che contiene informazioni sull'oggetto BRB corrente.

BtAddress

Indirizzo Bluetooth del dispositivo remoto in cui aprire un canale SCO.

TransmitBandwidth

Larghezza di banda di trasmissione, in byte al secondo, da assegnare al canale SCO.

ReceiveBandwidth

Larghezza di banda di ricezione, in byte al secondo, da assegnare al canale SCO.

MaxLatency

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

Valori	Descrizione
0x0000 a 0x0003	Riservato per utilizzi futuri.
0x0004 a 0xFFFE	Intervallo dei possibili valori maxLatency per il canale.
0xFFFF	Il canale non ha un'impostazione di MaxLatency preferita.

PacketType

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

SCO_HV1

SCO_HV2

SCO_HV3

SCO_EV3

SCO_EV4

SCO_EV5

ContentFormat

Impostazioni vocali audio per il canale. Usare le definizioni seguenti per codificare 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 utilizzi futuri. Non usare.

RetransmissionEffort

Una SCO_RETRANSMISSION_EFFORT valore di enumerazione che determina i criteri di ritrasmissione per il canale.

ChannelFlags

Flag che specificano i requisiti per l'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.

CallbackFlags

Flag che specifica quando la funzione assegnata al membro callback deve essere inviata al client. Attualmente è presente un solo flag valido:

Bandiera	Descrizione
SCO_CALLBACK_DISCONNECT	Il driver del profilo deve ricevere una notifica quando il dispositivo remoto è disconnesso.

Callback

La funzione di callback SCO implementata dal driver del profilo, che lo stack di driver Bluetooth deve chiamare per notificare al driver del profilo eventuali modifiche alla connessione SCO.

CallbackContext

Contesto da passare alla funzione di callback specificata nel membro Callback . Il driver del profilo definisce questo valore.

ReferenceObject

Puntatore a un oggetto di cui passare ObReferenceObject e ObDereferenceObject per cui mantenere un conteggio dei riferimenti.

ChannelHandle

Handle per identificare il canale SCO, se la richiesta del canale aperto viene completata correttamente.

Response

Flag che indica se il server locale accetterà o rifiuterà una connessione SCO in ingresso. Questo membro viene usato solo quando si compila e si invia una richiesta di BRB_SCO_OPEN_CHANNEL_RESPONSE . I valori di flag validi sono elencati nella tabella seguente.

Flag	Descrizione
SCO_CONNECT_RSP_RESPONSE_SUCCESS	Il server locale accetta la richiesta di connessione SCO.
SCO_CONNECT_RSP_RESPONSE_NO_RESOURCES	Il server locale rifiuta la richiesta di connessione sco a causa di una mancanza di risorse.
SCO_CONNECT_RSP_RESPONSE_SECURITY_BLOCK	Il server locale rifiuta la richiesta di connessione SCO perché la richiesta non soddisfa i requisiti di sicurezza.
SCO_CONNECT_RSP_RESPONSE_BAD_BD_ADDR	Il server locale rifiuta la richiesta di connessione SCO perché non accetta connessioni dall'indirizzo del dispositivo Bluetooth specificato.

Commenti

Per aprire un canale SCO, i driver di profilo devono compilare e inviare una richiesta di BRB_SCO_OPEN_CHANNEL .

Se il collegamento asincrono senza connessione al dispositivo remoto non esiste prima della richiesta, lo stack di driver Bluetooth ne crea uno prima di creare il canale SCO.

Per accettare o rifiutare una richiesta di connessione SCO in ingresso avviata da un dispositivo remoto, i driver di profilo devono compilare e inviare un BRB_SCO_OPEN_CHANNEL_RESPONSE richiesta.

Un driver di profilo deve compilare e inviare una richiesta di BRB_SCO_OPEN_CHANNEL_RESPONSE quando lo stack di driver Bluetooth chiama la funzione di callback SCO del driver del profilo e passa ScoIndicationRemoteConnect nel parametro Indication della funzione di callback.

Il driver del profilo specifica se la connessione deve essere accettata archiviando un valore appropriato nel membro Response di questa struttura. In questo contesto, il sistema locale è il server.