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

Para las indicaciones de solicitud de conexión remota entrantes, este es el contexto especificado por el controlador de perfil en el miembro IndicationCallbackContext 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

None

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 de controladores 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 de BRB_L2CA_OPEN_CHANNEL , el controlador de perfil registra su función de devolución de llamada L2CAP mediante el miembro de devolución de llamada de la estructura de _BRB_L2CA_OPEN_CHANNEL que se pasa cuando el controlador de perfil crea 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 se asocia con el canal que el BRB abrió. La pila del controlador 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 única 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 de INDICATION_PARAMETERS contenida 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	Value
Cliente mínimo compatible	Versions:_Supported en Windows Vista y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	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