Compartilhar via


estrutura INDICATION_PARAMETERS_ENHANCED (bthddi.h)

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

Sintaxe

typedef struct _INDICATION_PARAMETERS_ENHANCED {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED ResponseParams;
      USHORT                             Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RejectedParams;
      PCO_TYPE                           UnknownTypes;
      ULONG                              NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED 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;
    PVOID Reserved;
  } Parameters;
} *PINDICATION_PARAMETERS_ENHANCED, INDICATION_PARAMETERS_ENHANCED;

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/Multiplexer de Serviço (PSM) que é passado para a função de chamada quando o valor de INDICATION_CODE IndicationRemoteConnect é especificado no parâmetro Indication da função de retorno de chamada aprimorado.

Parameters.ConfigRequest

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

Parameters.ConfigRequest.CurrentParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigRequest.RequestedParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigRequest.ResponseParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 aprimorada 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 INDICATION_CODE IndicationRemoteConfigResponse .

Parameters.ConfigResponse.CurrentParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigResponse.RequestedParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigResponse.RejectedParams

Uma estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 estrutura CHANNEL_CONFIG_PARAMETERS_ENHANCED que contém as configurações de parâmetro para a função de retorno de chamada aprimorada 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 aprimorada 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 INDICATION_CODE IndicationFreeExtraOptions .

Parameters.FreeExtraOptions.NumExtraOptions

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

Parameters.FreeExtraOptions.ExtraOptions

Opções extras.

Parameters.Disconnect

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

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 INDICATION_CODE IndicationRecvPacket .

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.

Parameters.Reserved

Membro reservado. Não use.

Requisitos

Requisito Valor
Cliente mínimo com suporte Versões:_Supported em Windows 8 e versões posteriores do Windows
Cabeçalho bthddi.h (inclua Bthddi.h)