Compartilhar via

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

  • Artigo

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, esse é o membro CallbackContext especificado pelo driver de perfil quando ele foi criado e enviou um _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.

Retornar valor

Nenhum

Comentários

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

  1. 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 tentar contatá-lo.
  2. Quando o driver de perfil atua como um cliente e tenta se conectar a um dispositivo remoto usando a BRB_L2CA_OPEN_CHANNEL BRB, o driver de perfil registra sua função de retorno de chamada L2CAP usando o membro de retorno de chamada da estrutura _BRB_L2CA_OPEN_CHANNEL que é passada quando o driver de perfil cria 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 no 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 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 Indication . Para a maioria das notificações, há um membro do INDICATION_PARAMETERS união que corresponde ao evento e contém parâmetros específicos do evento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Versões:_Supported no Windows Vista e posteriores.
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)

Confira também

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER