struttura _BRB_L2CA_UPDATE_CHANNEL (bthddi.h)
La struttura _BRB_L2CA_UPDATE_CHANNEL descrive un aggiornamento delle caratteristiche di collegamento di un canale L2CAP aperto a un dispositivo remoto o per verificare quando determinati attributi del canale sono stati modificati.
Sintassi
struct _BRB_L2CA_UPDATE_CHANNEL {
BRB_HEADER Hdr;
BTH_ADDR BtAddress;
L2CAP_CHANNEL_HANDLE ChannelHandle;
ULONG NewChannelFlags;
ULONG FailedChannelFlags;
};
Membri
Hdr
Struttura BRB_HEADER che contiene informazioni sull'oggetto BRB corrente.
BtAddress
Indirizzo Bluetooth del dispositivo remoto.
ChannelHandle
Handle del canale L2CAP restituito dallo stack di driver Bluetooth in risposta a un BRB_L2CA_OPEN_CHANNEL precedente o BRB_L2CA_OPEN_CHANNEL_RESPONSE richiesta.
NewChannelFlags
Combinazione di valori di flag che specificano i requisiti aggiornati per il canale. Questo membro deve essere impostato su CF_ROLE_EITHER.
FailedChannelFlags
Il flag o i flag nel NewChannelFlags membro che lo stack di driver Bluetooth non è stato in grado di rispettare. Questo membro contiene informazioni solo se la chiamata BRB non è riuscita.
Osservazioni
Per recuperare le impostazioni correnti di un canale L2CAP, i driver di profilo devono compilare e inviare una richiesta di BRB_L2CA_UPDATE_CHANNEL.
Il driver del profilo può quindi determinare quando determinati attributi del canale sono stati modificati. Inoltre, se il flag di CF_LINK_PASSIVE_MODE non è impostato, BRB tenterà di modificare le impostazioni del canale corrente nel dispositivo remoto.
L'uso principale di BRB_L2CA_UPDATE_CHANNEL consiste nel determinare quando l'autenticazione o la crittografia è stata abilitata per una connessione.
In alcuni casi, le connessioni L2CAP possono essere stabilite senza il driver del profilo che specifica che l'autenticazione è necessaria, ma l'autenticazione verrà eseguita automaticamente a causa delle scelte effettuate dall'utente. In questo caso, passa un periodo di tempo compreso tra il momento in cui viene stabilita la connessione e quando l'autenticazione e la crittografia iniziano a funzionare. Le chiamate a BRB_L2CA_UPDATE_CHANNEL vengono bloccate fino al completamento dell'autenticazione e della crittografia.
Creando e inviando una richiesta di BRB_L2CA_UPDATE_CHANNEL, i driver di profilo possono evitare di usare la connessione prima dell'autenticazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| intestazione | bthddi.h (include Bthddi.h) |