PFNSCO_INDICATION_CALLBACK funzione di callback (bthddi.h)
I driver del profilo implementano una funzione di callback sco per fornire allo stack di driver Bluetooth un meccanismo per notificare al driver del profilo le richieste di connessione sco in ingresso dai dispositivi remoti e le modifiche apportate allo stato di una connessione SCO attualmente aperta.
Sintassi
PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;
void PfnscoIndicationCallback(
[in] PVOID Context,
[in] SCO_INDICATION_CODE Indication,
[in] PSCO_INDICATION_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 della struttura _BRB_SCO_REGISTER_SERVER quando il driver del profilo ha registrato la funzione di callback. Per le modifiche alle connessioni SCO esistenti, si tratta del membro CallbackContext specificato dal driver del profilo quando è stato compilato e inviato un BRB_SCO_OPEN_CHANNEL BRB.
[in] Indication
Valore SCO_INDICATION_CODE che indica il tipo di evento SCO.
[in] Parameters
Una SCO_INDICATION_PARAMETERS struttura che contiene informazioni sui parametri in base al valore passato al parametro Indicazione .
Valore restituito
nessuno
Osservazioni
Il membro BtAddress trovato nella struttura SCO_INDICATION_PARAMETERS passato nel parametro Parameters indica l'indirizzo Bluetooth del dispositivo remoto.
La funzione PFNSCO_INDICATION_CALLBACK può essere registrata in due modi.
Nel primo caso, il driver del profilo funge da server e deve registrare questa funzione di callback tramite il membro IndicationCallback della struttura _BRB_SCO_REGISTER_SERVER . Lo stack di driver Bluetooth può quindi chiamare questa funzione per notificare al driver del profilo quando un dispositivo remoto tenta di contattarlo.
Nel secondo caso, il driver del profilo funge da client e tenta di connettersi a un dispositivo remoto usando il BRB_SCO_OPEN_CHANNEL BRB. La funzione di callback PFNSCO_INDICATION_CALLBACK viene registrata tramite il membro Callback della struttura _BRB_SCO_OPEN_CHANNEL passata con il BRB specificato quando uno di essi viene inviato tramite IOCTL_INTERNAL_BTH_SUBMIT_BRB.
Dopo la registrazione, la funzione di callback è associata solo al canale aperto dal BRB e la funzione notifica il driver del profilo di azioni che si verificano sul canale aperto al dispositivo remoto. I driver di profilo possono registrare una singola funzione per gestire le notifiche del canale come client e _BRB_SCO_REGISTER_SERVER notifiche come server.
La struttura SCO_INDICATION_PARAMETERS contenuta nel parametro Parameters viene interpretata in base al valore SCO_INDICATION_CODE passato alla funzione di callback tramite il parametro Indicazione . Per la maggior parte delle notifiche, è presente un membro dell'unione SCO_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) |