estrutura _BRB_SCO_REGISTER_SERVER (bthddi.h)

Artigo
08/07/2023

Um driver de perfil usa a estrutura _BRB_SCO_REGISTER_SERVER para se registrar como um servidor capaz de receber conexões SCO de dispositivos Bluetooth remotos.

Sintaxe

struct _BRB_SCO_REGISTER_SERVER {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      Reserved;
  ULONG                      IndicationFlags;
  PFNSCO_INDICATION_CALLBACK IndicationCallback;
  PVOID                      IndicationCallbackContext;
  PVOID                      ReferenceObject;
  SCO_SERVER_HANDLE          ServerHandle;
};

Membros

Hdr

Uma estrutura BRB_HEADER que contém informações sobre o BRB atual.

BtAddress

O endereço do dispositivo Bluetooth remoto para o qual receber notificações.

Reserved

Reservado para uso futuro. Não use.

IndicationFlags

Um sinalizador que indica quando a função de retorno de chamada especificada no membro IndicationCallback deve ser chamada. Os sinalizadores a seguir são definidos.

Sinalizador	Descrição
SCO_INDICATION_SCO_REQUEST	Notifique o driver de perfil se houver conexões SCO de entrada.
SCO_INDICATION_ESCO_REQUEST	Notifique o driver de perfil se houver conexões eSCO de entrada.

IndicationCallback

Uma função de retorno de chamada SCO, implementada pelo driver de perfil, que a pilha de driver Bluetooth deve chamar para notificar o driver de perfil sobre conexões SCO de entrada.

IndicationCallbackContext

O contexto passado para a função definida no membro IndicationCallback .

ReferenceObject

Um ponteiro para um objeto a ser passado para as funções ObReferenceObject e ObDereferenceObject para manter uma contagem de referência. Os drivers de perfil devem fornecer esse objeto de forma que a pilha de driver Bluetooth possa aumentar a contagem do objeto, desde que a pilha de driver possa chamar a função de retorno de chamada especificada no membro IndicationCallback . A pilha de driver Bluetooth diminuirá a contagem de referência do objeto quando o driver de perfil compilar e enviar um BRB_SCO_UNREGISTER_SERVER solicitação.

ServerHandle

Identificador para o servidor SCO, se retornado com êxito. Quando o driver de perfil não deve mais receber indicações de conexão remota, ele deve passar esse identificador para BRB_SCO_UNREGISTER_SERVER.

Comentários

Para se registrar como um servidor SCO, um driver de perfil deve criar e enviar uma solicitação de BRB_SCO_REGISTER_SERVER .

Se tiver êxito, a pilha de driver Bluetooth poderá notificar o driver de perfil quando dispositivos remotos tentarem criar uma conexão SCO com o driver de perfil.

Depois que o driver de perfil tiver se registrado, a pilha de driver Bluetooth poderá notificá-lo quando um dispositivo remoto tentar se conectar a ele chamando a Função de Retorno de Chamada SCO que o driver de perfil implementa e especifica no membro IndicationCallback .

Quando o driver de perfil recebe a notificação de uma tentativa de conexão, ele deve compilar e enviar um BRB_SCO_OPEN_CHANNEL_RESPONSE solicitação para aceitar ou rejeitar a tentativa de conexão. Para obter mais informações sobre como aceitar ou rejeitar tentativas de conexão SCO, consulte a estrutura _BRB_SCO_OPEN_CHANNEL .

Depois que uma conexão é estabelecida, o driver de perfil pode emitir outros BRBs para se comunicar com o dispositivo remoto.

Para parar de receber notificações de conexão remota, um driver de perfil deve compilar e enviar um BRB_SCO_UNREGISTER_SERVER solicitação.