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

Artículo
08/07/2023

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

Sintaxis

PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;

void PfnscoIndicationCallback(
  [in] PVOID Context,
  [in] SCO_INDICATION_CODE Indication,
  [in] PSCO_INDICATION_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 de la estructura _BRB_SCO_REGISTER_SERVER cuando el controlador de perfil registró la función de devolución de llamada. Para los cambios en las conexiones SCO existentes, este es el miembro CallbackContext especificado por el controlador de perfil cuando se creó y envió un BRB_SCO_OPEN_CHANNEL BRB.

[in] Indication

Valor de SCO_INDICATION_CODE que indica el tipo de evento SCO.

[in] Parameters

A SCO_INDICATION_PARAMETERS estructura que contiene información de parámetros en función del valor pasado al parámetro De indicación .

Valor devuelto

None

Observaciones

El miembro BtAddress que se encuentra en la estructura SCO_INDICATION_PARAMETERS pasada en el parámetro Parameters indica la dirección Bluetooth del dispositivo remoto.

La función PFNSCO_INDICATION_CALLBACK se puede registrar de dos maneras.

En el primer caso, el controlador de perfil actúa como servidor y debe registrar esta función de devolución de llamada a través del miembro IndicationCallback de la estructura _BRB_SCO_REGISTER_SERVER . A continuación, la pila del controlador Bluetooth puede llamar a esta función para notificar al controlador de perfil cuando un dispositivo remoto intenta ponerse en contacto con ella.

En el segundo caso, el controlador de perfil actúa como un cliente e intenta conectarse a un dispositivo remoto mediante el BRB_SCO_OPEN_CHANNEL BRB. La función de devolución de llamada PFNSCO_INDICATION_CALLBACK se registra a través del miembro Callback de la estructura de _BRB_SCO_OPEN_CHANNEL pasada con el BRB especificado cuando se envía uno de ellos a través de IOCTL_INTERNAL_BTH_SUBMIT_BRB.

Una vez registrada, la función de devolución de llamada solo está asociada al canal que el BRB abrió y la función notifica al controlador de perfil de las acciones que se producen a través del canal abierto al dispositivo remoto. Los controladores de perfil pueden registrar una sola función para controlar las notificaciones de canal como cliente y _BRB_SCO_REGISTER_SERVER notificaciones como servidor.

La estructura de SCO_INDICATION_PARAMETERS contenida en el parámetro Parameters se interpreta según el valor de SCO_INDICATION_CODE que se pasa a la función de devolución de llamada a través del parámetro Indication . Para la mayoría de las notificaciones, hay un miembro de unión SCO_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).