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) |