estrutura INDICATION_PARAMETERS (bthddi.h)

Artigo
02/22/2024

A estrutura INDICATION_PARAMETERS é passada como o parâmetro Parameters para a função de retorno de chamada L2CAP de um driver de perfil

Sintaxe

typedef struct _INDICATION_PARAMETERS {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS ResponseParams;
      USHORT                    Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS RejectedParams;
      PCO_TYPE                  UnknownTypes;
      ULONG                     NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS NewRequestParams;
      USHORT                    Response;
    } ConfigResponse;
    struct {
      ULONG                NumExtraOptions;
      PL2CAP_CONFIG_OPTION ExtraOptions;
    } FreeExtraOptions;
    struct {
      L2CAP_DISCONNECT_REASON Reason;
      BOOLEAN                 CloseNow;
    } Disconnect;
    struct {
      ULONG PacketLength;
      ULONG TotalQueueLength;
    } RecvPacket;
  } Parameters;
} *PINDICATION_PARAMETERS, INDICATION_PARAMETERS;

Membros

ConnectionHandle

O identificador de conexão L2CAP para o dispositivo remoto. Esse identificador só é válido para notificações que chegam por meio de uma conexão L2CAP estabelecida.

BtAddress

O endereço Bluetooth do dispositivo remoto.

Parameters

Parameters.Connect

A estrutura que contém parâmetros para a função de retorno de chamada IndicationRemoteConnect .

Parameters.Connect.Request

A estrutura que contém os parâmetros de uma solicitação de conexão.

Parameters.Connect.Request.PSM

O Protocolo/Multiplexador de Serviço (PSM) que é passado para a função de chamada quando o valor IndicationRemoteConnectINDICATION_CODE é especificado no parâmetro Indication da função de retorno de chamada.

Parameters.ConfigRequest

A estrutura que contém parâmetros para o valor IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.CurrentParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS que contém os parâmetros do canal atual. Esse valor só será válido se o canal estiver aberto anteriormente e agora estiver em processo de configuração. Esse membro é usado quando a função de retorno de chamada especifica o valor IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.RequestedParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS que contém os parâmetros passados do host remoto para solicitações de configuração. Esse membro é usado quando a função de retorno de chamada especifica o valor IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.ResponseParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS que contém os parâmetros com os quais o driver de perfil responde à solicitação de configuração.

Parameters.ConfigRequest.Response

Um sinalizador que indica o status da solicitação de configuração. Os valores de sinalizador válidos são listados na tabela a seguir.

Sinalizador	Descrição
CONFIG_STATUS_SUCCESS	A solicitação de configuração foi bem-sucedida.
CONFIG_STATUS_DISCONNECT	Falha na solicitação de configuração porque a conexão L2CAP foi desconectada.
CONFIG_STATUS_INVALID_PARAMETER	Falha na solicitação de configuração porque um parâmetro inválido foi passado para o driver de perfil.
CONFIG_STATUS_REJECT	O driver de perfil rejeitou a solicitação de configuração.
CONFIG_STATUS_UNKNOWN_OPTION	A solicitação de configuração falhou porque uma das opções de configuração especificadas não foi reconhecida pelo driver de perfil.

Parameters.ConfigResponse

A estrutura que contém parâmetros para o valor IndicationRemoteConfigResponseINDICATION_CODE .

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

Uma *CHANNEL_CONFIG_PARAMETERS estrutura que contém as configurações de parâmetro de configuração que foram rejeitadas pelo dispositivo remoto.

Parameters.ConfigResponse.UnknownTypes

Uma matriz de tipos que não foram reconhecidos pelo dispositivo que responde.

Parameters.ConfigResponse.NumUnknownTypes

O número de tipos não reconhecidos no membro UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

Uma *CHANNEL_CONFIG_PARAMETERS estrutura que contém as configurações de parâmetro da função de retorno de chamada a ser reenviada após a resposta ter retornado do dispositivo remoto.

Parameters.ConfigResponse.Response

Um sinalizador que indica o status da solicitação de configuração. Os valores de sinalizador válidos são listados na tabela a seguir.

Sinalizador	Descrição
CONFIG_STATUS_SUCCESS	A solicitação de configuração foi bem-sucedida.
CONFIG_STATUS_DISCONNECT	Falha na solicitação de configuração porque a conexão L2CAP foi desconectada.
CONFIG_STATUS_INVALID_PARAMETER	Falha na solicitação de configuração porque um parâmetro inválido foi passado para o driver de perfil.
CONFIG_STATUS_REJECT	O driver de perfil rejeitou a solicitação de configuração.
CONFIG_STATUS_UNKNOWN_OPTION	A solicitação de configuração falhou porque uma das opções de configuração especificadas não foi reconhecida pelo driver de perfil.

Parameters.FreeExtraOptions

A estrutura que contém parâmetros para o valor IndicationFreeExtraOptionsINDICATION_CODE .

Parameters.FreeExtraOptions.NumExtraOptions

O número de opções extras contidas no membro ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

O número de opções extras contidas no membro ExtraOptions .

Parameters.Disconnect

A estrutura que contém os parâmetros para o valor IndicationRemoteDisconnectINDICATION_CODE .

Parameters.Disconnect.Reason

Um valor L2CAP_DISCONNECT_REASON que indica por que a conexão L2CAP com o dispositivo remoto foi encerrada.

Parameters.Disconnect.CloseNow

Um valor booliano que um driver de perfil usa para notificar a pilha de driver Bluetooth para fechar a conexão L2CAP. Defina esse membro como TRUE para notificar a pilha do driver Bluetooth para fechar a conexão. Caso contrário, defina-o como FALSE para manter a conexão aberta.

Parameters.RecvPacket

A estrutura que contém os parâmetros para o valor IndicationRecvPacketINDICATION_CODE .

Parameters.RecvPacket.PacketLength

O tamanho, em bytes, do pacote que a função de retorno de chamada enviou pela conexão L2CAP.

Parameters.RecvPacket.TotalQueueLength

O número de pacotes a serem processados pela conexão L2CAP.

Comentários

A Função de Retorno de Chamada L2CAP de um driver de perfil deve processar essa estrutura de forma diferente dependendo do valor que a pilha do driver Bluetooth passa no parâmetro Indication da função de retorno de chamada.

Quando a pilha de driver Bluetooth passar por IndicationRemoteConnect, a função de retorno de chamada deverá usar o membro Connect da união Parameters .
Quando a pilha do driver Bluetooth passar por IndicationRemoteDisconnect, a função de retorno de chamada deverá usar o membro Disconnect da união Parameters .
Quando a pilha de driver Bluetooth passa por IndicationRemoteConfigRequest, a função de retorno de chamada deve usar o membro ConfigRequest da união Parameters .
Quando a pilha de driver Bluetooth passa por IndicationRemoteConfigResponse, a função de retorno de chamada deve usar o membro ConfigResponse da união Parameters .
Quando a pilha de driver Bluetooth passa por IndicationRemoteFreeExtraOptions, a função de retorno de chamada deve usar o membro FreeExtraOptions da união Parameters .
Quando a pilha de driver bluetooth passa por IndicationRemoteRecvPacket, a função de retorno de chamada deve usar o membro RecvPacket da união Parameters .