PFNBTHPORT_INDICATION_CALLBACK función de devolución de llamada (bthddi.h)

Los controladores de perfil implementan una función de devolución de llamada L2CAP para proporcionar a la pila de controladores Bluetooth un mecanismo para notificar al controlador de perfil las solicitudes de conexión L2CAP entrantes desde dispositivos remotos y cualquier cambio en el estado de una conexión L2CAP abierta actualmente.

Sintaxis

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

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

Parámetros

[in] Context

En el caso de las indicaciones de solicitud de conexión remota entrantes, este es el contexto especificado por el controlador de perfil en el IndicationCallbackContext miembro del elemento _BRB_L2CA_REGISTER_SERVER estructura cuando el controlador de perfil registró la función de devolución de llamada. Para los cambios en las conexiones L2CAP existentes, este es el miembro callbackContext especificado por el controlador de perfil al compilar y enviar un _BRB_L2CA_OPEN_CHANNEL BRB.

[in] Indication

Valor INDICATION_CODE que indica el tipo de evento L2CAP.

[in] Parameters

Estructura INDICATION_PARAMETERS que contiene parámetros específicos del evento.

Valor devuelto

Ninguno

Observaciones

Un controlador de perfil registra su función de devolución de llamada L2CAP en los dos escenarios siguientes:

1. Cuando un controlador de perfil actúa como servidor, registra una función de devolución de llamada L2CAP mediante el miembro IndicationCallback del _BRB_L2CA_REGISTER_SERVER estructura. A continuación, la pila del controlador Bluetooth puede notificar al controlador de perfil cuando un dispositivo remoto intenta ponerse en contacto con él.
2. Cuando el controlador de perfil actúa como cliente e intenta conectarse a un dispositivo remoto mediante el BRB_L2CA_OPEN_CHANNEL BRB, el controlador de perfil registra su función de devolución de llamada L2CAP mediante el miembro Devolución de llamada de la estructura de _BRB_L2CA_OPEN_CHANNEL que se pasa cuando el controlador de perfil compila y envía un BRB_L2CA_OPEN_CHANNEL o BRB_L2CA_OPEN_CHANNEL_RESPONSE solicitud.

Una vez que el controlador de perfil registra su función de devolución de llamada L2CAP, la función de devolución de llamada solo está asociada al canal que el BRB abrió. La pila de controladores Bluetooth puede llamar a la función de devolución de llamada L2CAP para notificar al controlador de perfil las acciones que se producen a través del canal abierto al dispositivo remoto. Los controladores de perfil pueden registrar una sola función de devolución de llamada para controlar las notificaciones de canal como un cliente y las notificaciones de conexión como servidor.

La estructura INDICATION_PARAMETERS que se mantiene en el parámetro Parameters se interpreta según el valor de la enumeración INDICATION_CODE que la pila del controlador Bluetooth pasa a la función de devolución de llamada L2CAP del controlador de perfil a través del parámetro Indicación. Para la mayoría de las notificaciones, hay un miembro de unión INDICATION_PARAMETERS que corresponde al evento y contiene parámetros específicos del evento.

Requisitos

Requisito	Valor
cliente mínimo admitido	Versiones: _Supported en Windows Vista y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	bthddi.h (incluya Bthddi.h)
irQL	Los desarrolladores deben codificar esta función para que funcione en IRQL = DISPATCH_LEVEL (si la función de devolución de llamada no tiene acceso a la memoria paginada) o IRQL = PASSIVE_LEVEL (si la función de devolución de llamada debe tener acceso a la memoria paginada).

Consulte también

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER