estrutura INDICATION_PARAMETERS (bthddi.h)
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
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.ConfigResponse.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.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 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Versões:_Supported no Windows Vista e posteriores. |
| Cabeçalho | bthddi.h (inclua Bthddi.h) |