PFNSCO_INDICATION_CALLBACK função de retorno de chamada (bthddi.h)
Os drivers de perfil implementam uma função de retorno de chamada SCO para fornecer à pilha de driver Bluetooth um mecanismo para notificar o driver de perfil sobre solicitações de conexão SCO de entrada de dispositivos remotos e quaisquer alterações no status de uma conexão SCO aberta no momento.
Sintaxe
PFNSCO_INDICATION_CALLBACK PfnscoIndicationCallback;
void PfnscoIndicationCallback(
[in] PVOID Context,
[in] SCO_INDICATION_CODE Indication,
[in] PSCO_INDICATION_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 da estrutura _BRB_SCO_REGISTER_SERVER quando o driver de perfil registrou a função de retorno de chamada. Para alterações em conexões SCO existentes, esse é o membro CallbackContext especificado pelo driver de perfil quando ele criou e enviou um BRB_SCO_OPEN_CHANNEL BRB.
[in] Indication
Um valor SCO_INDICATION_CODE que indica o tipo de evento SCO.
[in] Parameters
A SCO_INDICATION_PARAMETERS estrutura que contém informações de parâmetro com base no valor passado para o parâmetro Indication .
Retornar valor
Nenhum
Comentários
O membro BtAddress encontrado na estrutura SCO_INDICATION_PARAMETERS passada no parâmetro Parameters indica o endereço Bluetooth do dispositivo remoto.
A função PFNSCO_INDICATION_CALLBACK pode ser registrada de duas maneiras.
No primeiro caso, o driver de perfil atua como um servidor e deve registrar essa função de retorno de chamada por meio do membro IndicationCallback da estrutura _BRB_SCO_REGISTER_SERVER . Em seguida, a pilha de driver Bluetooth pode chamar essa função para notificar o driver de perfil quando um dispositivo remoto tentar contatá-lo.
No segundo caso, o driver de perfil atua como um cliente e tenta se conectar a um dispositivo remoto usando o BRB_SCO_OPEN_CHANNEL BRB. A função de retorno de chamada PFNSCO_INDICATION_CALLBACK é registrada por meio do membro callback da estrutura _BRB_SCO_OPEN_CHANNEL passada com o BRB especificado quando um deles é enviado por meio de IOCTL_INTERNAL_BTH_SUBMIT_BRB.
Depois de registrada, a função de retorno de chamada só é associada ao canal que o BRB abriu e a função notifica 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 para lidar com notificações de canal como um cliente e _BRB_SCO_REGISTER_SERVER notificações como um servidor.
A estrutura SCO_INDICATION_PARAMETERS mantida no parâmetro Parameters é interpretada de acordo com o valor SCO_INDICATION_CODE que é passado para a função de retorno de chamada por meio do parâmetro Indication . Para a maioria das notificações, há um membro da união SCO_INDICATION_PARAMETERS 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 posterior. |
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) |