PFNBTHPORT_INDICATION_CALLBACK função de retorno de chamada (bthddi.h)

Artigo
02/06/2025

Os drivers de perfil implementam uma função de retorno de chamada L2CAP para fornecer à pilha de driver Bluetooth um mecanismo para notificar o driver de perfil sobre solicitações de conexão L2CAP de entrada de dispositivos remotos e quaisquer alterações no status de uma conexão L2CAP aberta no momento.

Sintaxe

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

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

Parâmetros

[in] Context

Para indicações de solicitação de conexão remota de entrada, esse é o contexto especificado pelo driver de perfil no membro IndicationCallbackContext do _BRB_L2CA_REGISTER_SERVER estrutura quando o driver de perfil registrou a função de retorno de chamada. Para alterações em conexões L2CAP existentes, este é o membro CallbackContext especificado pelo driver de perfil quando ele criou e enviou uma _BRB_L2CA_OPEN_CHANNEL BRB.

[in] Indication

Um valor INDICATION_CODE que indica o tipo de evento L2CAP.

[in] Parameters

Uma estrutura INDICATION_PARAMETERS que contém parâmetros específicos do evento.

Valor de retorno

Nenhum

Observações

Um driver de perfil registra sua função de retorno de chamada L2CAP nos dois cenários a seguir:

Quando um driver de perfil atua como um servidor, ele registra uma função de retorno de chamada L2CAP usando o membro IndicationCallback do _BRB_L2CA_REGISTER_SERVER estrutura. A pilha de driver Bluetooth pode notificar o driver de perfil quando um dispositivo remoto tenta contatá-lo.
Quando o driver de perfil atua como um cliente e tenta se conectar a um dispositivo remoto usando o BRB_L2CA_OPEN_CHANNEL BRB, o driver de perfil registra sua função de retorno de chamada L2CAP usando o membro da estrutura de _BRB_L2CA_OPEN_CHANNEL que é passada quando o driver de perfil compila e envia um BRB_L2CA_OPEN_CHANNEL ou BRB_L2CA_OPEN_CHANNEL_RESPONSE solicitação.

Depois que o driver de perfil registra sua função de retorno de chamada L2CAP, a função de retorno de chamada só é associada ao canal que o BRB abriu. A pilha de driver Bluetooth pode chamar a função de retorno de chamada L2CAP para notificar o driver de perfil de ações que ocorrem pelo canal aberto para o dispositivo remoto. Os drivers de perfil podem registrar uma única função de retorno de chamada para lidar com notificações de canal como um cliente e notificações de conexão como um servidor.

A estrutura de INDICATION_PARAMETERS mantida no parâmetro Parameters é interpretada de acordo com o valor da enumeração INDICATION_CODE que a pilha de driver Bluetooth passa para a função de retorno de chamada L2CAP do driver de perfil por meio do parâmetro indicação de. Para a maioria das notificações, há um membro do sindicato INDICATION_PARAMETERS que corresponde ao evento e contém parâmetros específicos do evento.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Versões:_Supported no Windows Vista e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	bthddi.h (inclua Bthddi.h)
IRQL	Os desenvolvedores devem codificar essa função para operar em IRQL = DISPATCH_LEVEL (se a função de retorno de chamada não acessar memória paginada) ou IRQL = PASSIVE_LEVEL (se a função de retorno de chamada precisar acessar memória paginada)

Consulte também

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Compartilhar via