PFNBTHPORT_INDICATION_CALLBACK funzione di callback (bthddi.h)

Articolo
03/08/2023

I driver del profilo implementano una funzione di callback L2CAP per fornire allo stack di driver Bluetooth un meccanismo per notificare al driver del profilo le richieste di connessione L2CAP in ingresso dai dispositivi remoti e le modifiche apportate allo stato di una connessione L2CAP attualmente aperta.

Sintassi

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

Parametri

[in] Context

Per le indicazioni relative alle richieste di connessione remota in ingresso, si tratta del contesto specificato dal driver del profilo nel membro IndicationCallbackContext dell'oggetto _BRB_L2CA_REGISTER_SERVER struttura quando il driver del profilo ha registrato la funzione di callback. Per le modifiche alle connessioni L2CAP esistenti, si tratta del membro CallbackContext specificato dal driver del profilo quando è stato compilato e inviato un _BRB_L2CA_OPEN_CHANNEL BRB.

[in] Indication

Valore INDICATION_CODE che indica il tipo di evento L2CAP.

[in] Parameters

Struttura INDICATION_PARAMETERS contenente parametri specifici dell'evento.

Valore restituito

nessuno

Osservazioni

Un driver del profilo registra la funzione di callback L2CAP nei due scenari seguenti:

Quando un driver del profilo funge da server, registra una funzione di callback L2CAP usando il membro IndicationCallback dell'oggetto _BRB_L2CA_REGISTER_SERVER struttura. Lo stack di driver Bluetooth può quindi notificare al driver del profilo quando un dispositivo remoto tenta di contattarlo.
Quando il driver del profilo funge da client e tenta di connettersi a un dispositivo remoto usando il BRB_L2CA_OPEN_CHANNEL BRB, il driver del profilo registra la funzione di callback L2CAP usando il membro callback della struttura _BRB_L2CA_OPEN_CHANNEL passato quando il driver del profilo compila e invia un BRB_L2CA_OPEN_CHANNEL o BRB_L2CA_OPEN_CHANNEL_RESPONSE richiesta.

Dopo che il driver del profilo registra la funzione di callback L2CAP, la funzione di callback è associata solo al canale aperto dal BRB. Lo stack di driver Bluetooth può chiamare la funzione di callback L2CAP per notificare al driver del profilo azioni che si verificano sul canale aperto al dispositivo remoto. I driver del profilo possono registrare una singola funzione di callback per gestire le notifiche del canale come client e notifiche di connessione come server.

La struttura INDICATION_PARAMETERS contenuta nel parametro Parameters viene interpretata in base al valore dell'enumerazione INDICATION_CODE che lo stack di driver Bluetooth passa alla funzione di callback L2CAP del driver del profilo tramite il parametro Indicazione . Per la maggior parte delle notifiche, è presente un membro dell'unione INDICATION_PARAMETERS che corrisponde all'evento e contiene parametri specifici dell'evento.

Requisiti

Requisito	Valore
Client minimo supportato	Versioni:_Supported in Windows Vista e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	bthddi.h (include Bthddi.h)
IRQL	Gli sviluppatori devono codificare questa funzione per funzionare in IRQL = DISPATCH_LEVEL (se la funzione di callback non accede alla memoria in pagina) o IRQL = PASSIVE_LEVEL (se la funzione di callback deve accedere alla memoria paginata)

Vedi anche

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Condividi tramite