estructura INDICATION_PARAMETERS (bthddi.h)

Artículo
03/08/2023

La estructura de INDICATION_PARAMETERS se pasa como parámetro Parameters a la función de devolución de llamada L2CAP del controlador de perfil.

Sintaxis

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;

Miembros

ConnectionHandle

Identificador de conexión L2CAP al dispositivo remoto. Este identificador solo es válido para las notificaciones que llegan a través de una conexión L2CAP establecida.

BtAddress

La dirección Bluetooth del dispositivo remoto.

Parameters

Parameters.Connect

Estructura que contiene parámetros para la función de devolución de llamada IndicationRemoteConnect .

Parameters.Connect.Request

Estructura que contiene los parámetros de una solicitud de conexión.

Parameters.Connect.Request.PSM

Multiplexador de protocolo/servicio (PSM) que se pasa a la función que realiza la llamada cuando el valor de IndicationRemoteConnectINDICATION_CODE se especifica en el parámetro De indicación de la función de devolución de llamada.

Parameters.ConfigRequest

Estructura que contiene parámetros para el valor de IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.CurrentParams

Estructura CHANNEL_CONFIG_PARAMETERS que contiene los parámetros del canal actual. Este valor solo es válido si el canal estaba abierto anteriormente y ahora está en proceso de configuración. Este miembro se usa cuando la función de devolución de llamada especifica el valor IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.RequestedParams

Estructura CHANNEL_CONFIG_PARAMETERS que contiene los parámetros que se pasan desde el host remoto para las solicitudes de configuración. Este miembro se usa cuando la función de devolución de llamada especifica el valor IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.ResponseParams

Estructura CHANNEL_CONFIG_PARAMETERS que contiene los parámetros con los que responde el controlador de perfil a la solicitud de configuración.

Parameters.ConfigRequest.Response

Marca que indica el estado de la solicitud de configuración. Los valores de marca válidos se muestran en la tabla siguiente.

Marca	Descripción
CONFIG_STATUS_SUCCESS	La solicitud de configuración se realizó correctamente.
CONFIG_STATUS_DISCONNECT	Error en la solicitud de configuración porque se desconectó la conexión L2CAP.
CONFIG_STATUS_INVALID_PARAMETER	Error en la solicitud de configuración porque se pasó un parámetro no válido al controlador de perfil.
CONFIG_STATUS_REJECT	El controlador de perfil rechazó la solicitud de configuración.
CONFIG_STATUS_UNKNOWN_OPTION	Error en la solicitud de configuración porque el controlador de perfil no reconoció una de las opciones de configuración especificadas.

Parameters.ConfigResponse

Estructura que contiene parámetros para el valor de IndicationRemoteConfigResponseINDICATION_CODE .

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

Una estructura *CHANNEL_CONFIG_PARAMETERS que contiene las opciones de parámetro de configuración rechazadas por el dispositivo remoto.

Parameters.ConfigResponse.UnknownTypes

Matriz de tipos que el dispositivo que responde no reconoce.

Parameters.ConfigResponse.NumUnknownTypes

Número de tipos no reconocidos en el miembro UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

Una estructura *CHANNEL_CONFIG_PARAMETERS que contiene la configuración de parámetros de la función de devolución de llamada que se va a volver a enviar después de que la respuesta se haya devuelto desde el dispositivo remoto.

Parameters.ConfigResponse.Response

Marca que indica el estado de la solicitud de configuración. Los valores de marca válidos se muestran en la tabla siguiente.

Marca	Descripción
CONFIG_STATUS_SUCCESS	La solicitud de configuración se realizó correctamente.
CONFIG_STATUS_DISCONNECT	Error en la solicitud de configuración porque se desconectó la conexión L2CAP.
CONFIG_STATUS_INVALID_PARAMETER	Error en la solicitud de configuración porque se pasó un parámetro no válido al controlador de perfil.
CONFIG_STATUS_REJECT	El controlador de perfil rechazó la solicitud de configuración.
CONFIG_STATUS_UNKNOWN_OPTION	Error en la solicitud de configuración porque el controlador de perfil no reconoció una de las opciones de configuración especificadas.

Parameters.FreeExtraOptions

Estructura que contiene parámetros para el valor de IndicationFreeExtraOptionsINDICATION_CODE .

Parameters.FreeExtraOptions.NumExtraOptions

Número de opciones adicionales contenidas en el miembro ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Número de opciones adicionales contenidas en el miembro ExtraOptions .

Parameters.Disconnect

Estructura que contiene los parámetros del valor de IndicationRemoteDisconnectINDICATION_CODE .

Parameters.Disconnect.Reason

Valor de L2CAP_DISCONNECT_REASON que indica por qué se terminó la conexión L2CAP al dispositivo remoto.

Parameters.Disconnect.CloseNow

Valor booleano que usa un controlador de perfil para notificar a la pila del controlador Bluetooth que cierre la conexión L2CAP. Establezca este miembro en TRUE para notificar a la pila del controlador Bluetooth que cierre la conexión. De lo contrario, establézcalo en FALSE para mantener abierta la conexión.

Parameters.RecvPacket

Estructura que contiene los parámetros del valor de IndicationRecvPacketINDICATION_CODE .

Parameters.RecvPacket.PacketLength

Tamaño, en bytes, del paquete que la función de devolución de llamada envió a través de la conexión L2CAP.

Parameters.RecvPacket.TotalQueueLength

Número de paquetes que se van a procesar a través de la conexión L2CAP.

Comentarios

La función de devolución de llamada L2CAP de un controlador de perfil debe procesar esta estructura de forma diferente según el valor que pase la pila del controlador Bluetooth en el parámetro Indicación de la función de devolución de llamada.

Cuando la pila del controlador Bluetooth pasa IndicationRemoteConnect, la función de devolución de llamada debe usar el miembro Connect de la unión parameters .
Cuando la pila del controlador Bluetooth pasa IndicationRemoteDisconnect, la función de devolución de llamada debe usar el miembro Disconnect de la unión parameters .
Cuando la pila del controlador Bluetooth pasa IndicationRemoteConfigRequest, la función de devolución de llamada debe usar el miembro ConfigRequest de la unión parameters .
Cuando la pila del controlador Bluetooth pasa IndicationRemoteConfigResponse, la función de devolución de llamada debe usar el miembro ConfigResponse de la unión parameters .
Cuando la pila del controlador Bluetooth pasa IndicationRemoteFreeExtraOptions, la función de devolución de llamada debe usar el miembro FreeExtraOptions de la unión parameters .
Cuando la pila del controlador Bluetooth pasa IndicationRemoteRecvPacket, la función de devolución de llamada debe usar el miembro RecvPacket de la unión parameters .