structure INDICATION_PARAMETERS (bthddi.h)

Article
08/07/2023

La structure INDICATION_PARAMETERS est passée en tant que paramètre Parameters à la fonction de rappel L2CAP d’un pilote de profil

Syntaxe

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;

Membres

ConnectionHandle

Le handle de connexion L2CAP à l’appareil distant. Ce handle n’est valide que pour les notifications qui arrivent via une connexion L2CAP établie.

BtAddress

Adresse Bluetooth de l’appareil distant.

Parameters

Parameters.Connect

Structure qui contient les paramètres de la fonction de rappel IndicationRemoteConnect .

Parameters.Connect.Request

Structure qui contient les paramètres d’une demande de connexion.

Parameters.Connect.Request.PSM

Multiplexeur de protocole/service (PSM) passé à la fonction appelante lorsque la valeur IndicationRemoteConnectINDICATION_CODE est spécifiée dans le paramètre Indication de la fonction de rappel.

Parameters.ConfigRequest

Structure qui contient les paramètres de la valeur IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.CurrentParams

Structure CHANNEL_CONFIG_PARAMETERS qui contient les paramètres du canal actuel. Cette valeur n’est valide que si le canal était précédemment ouvert et qu’il est en cours de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.RequestedParams

Une structure CHANNEL_CONFIG_PARAMETERS qui contient les paramètres transmis à partir de l’hôte distant pour les demandes de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.ResponseParams

Une structure de CHANNEL_CONFIG_PARAMETERS qui contient les paramètres que le pilote de profil répond à la demande de configuration.

Parameters.ConfigRequest.Response

Indicateur qui indique le status de la demande de configuration. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant.

Indicateur	Description
CONFIG_STATUS_SUCCESS	La demande de configuration a réussi.
CONFIG_STATUS_DISCONNECT	La demande de configuration a échoué, car la connexion L2CAP a été déconnectée.
CONFIG_STATUS_INVALID_PARAMETER	La demande de configuration a échoué, car un paramètre non valide a été passé au pilote de profil.
CONFIG_STATUS_REJECT	Le pilote de profil a rejeté la demande de configuration.
CONFIG_STATUS_UNKNOWN_OPTION	La demande de configuration a échoué, car l’une des options de configuration spécifiées n’a pas été reconnue par le pilote de profil.

Parameters.ConfigResponse

Structure qui contient les paramètres de la valeur IndicationRemoteConfigResponseINDICATION_CODE .

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

*CHANNEL_CONFIG_PARAMETERS structure qui contient les paramètres de configuration qui ont été rejetés par l’appareil distant.

Parameters.ConfigResponse.UnknownTypes

Tableau de types qui n’ont pas été reconnus par l’appareil qui répond.

Parameters.ConfigResponse.NumUnknownTypes

Nombre de types non reconnus dans le membre UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

*CHANNEL_CONFIG_PARAMETERS structure qui contient les paramètres de paramètre de la fonction de rappel à soumettre à nouveau une fois la réponse retournée à partir de l’appareil distant.

Parameters.ConfigResponse.Response

Indicateur qui indique le status de la demande de configuration. Les valeurs d’indicateur valides sont répertoriées dans le tableau suivant.

Indicateur	Description
CONFIG_STATUS_SUCCESS	La demande de configuration a réussi.
CONFIG_STATUS_DISCONNECT	La demande de configuration a échoué, car la connexion L2CAP a été déconnectée.
CONFIG_STATUS_INVALID_PARAMETER	La demande de configuration a échoué, car un paramètre non valide a été passé au pilote de profil.
CONFIG_STATUS_REJECT	Le pilote de profil a rejeté la demande de configuration.
CONFIG_STATUS_UNKNOWN_OPTION	La demande de configuration a échoué, car l’une des options de configuration spécifiées n’a pas été reconnue par le pilote de profil.

Parameters.FreeExtraOptions

Structure qui contient les paramètres de la valeur IndicationFreeExtraOptionsINDICATION_CODE .

Parameters.FreeExtraOptions.NumExtraOptions

Nombre d’options supplémentaires contenues dans le membre ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Nombre d’options supplémentaires contenues dans le membre ExtraOptions .

Parameters.Disconnect

Structure qui contient les paramètres de la valeur IndicationRemoteDisconnectINDICATION_CODE .

Parameters.Disconnect.Reason

Valeur L2CAP_DISCONNECT_REASON qui indique la raison pour laquelle la connexion L2CAP à l’appareil distant a été arrêtée.

Parameters.Disconnect.CloseNow

Valeur booléenne qu’un pilote de profil utilise pour avertir la pile de pilotes Bluetooth de fermer la connexion L2CAP. Définissez ce membre sur TRUE pour avertir la pile de pilotes Bluetooth de fermer la connexion. Sinon, définissez-le sur FALSE pour que la connexion reste ouverte.

Parameters.RecvPacket

Structure qui contient les paramètres de la valeur IndicationRecvPacketINDICATION_CODE .

Parameters.RecvPacket.PacketLength

Taille, en octets, du paquet envoyé par la fonction de rappel via la connexion L2CAP.

Parameters.RecvPacket.TotalQueueLength

Nombre de paquets à traiter via la connexion L2CAP.

Remarques

La fonction de rappel L2CAP d’un pilote de profil doit traiter cette structure différemment en fonction de la valeur que la pile de pilotes Bluetooth transmet dans le paramètre Indication de la fonction de rappel.

Lorsque la pile de pilotes Bluetooth passe indicationRemoteConnect, la fonction de rappel doit utiliser le membre Connect de l’union Paramètres .
Lorsque la pile de pilotes Bluetooth passe indicationRemoteDisconnect, la fonction de rappel doit utiliser le membre Déconnecter de l’union Paramètres .
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteConfigRequest, la fonction de rappel doit utiliser le membre ConfigRequest de l’union Parameters .
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteConfigResponse, la fonction de rappel doit utiliser le membre ConfigResponse de l’union Parameters .
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteFreeExtraOptions, la fonction de rappel doit utiliser le membre FreeExtraOptions de l’union Parameters .
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteRecvPacket, la fonction de rappel doit utiliser le membre RecvPacket de l’union Parameters .