Partager via

structure INDICATION_PARAMETERS_ENHANCED (bthddi.h)

  • Article

La structure INDICATION_PARAMETERS_ENHANCED est passée en tant que paramètre Parameters à la fonction de rappel L2CAP améliorée du pilote de profil

Syntaxe

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;

Membres

ConnectionHandle

Handle de connexion L2CAP sur l’appareil distant. Ce handle est valide uniquement pour les notifications qui arrivent sur une connexion L2CAP établie.

BtAddress

Adresse Bluetooth de l’appareil distant.

Parameters

Parameters.Connect

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

Parameters.Connect.Request

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

Parameters.Connect.Request.PSM

Le multiplexeur de protocole/service (PSM) passé à la fonction appelante lorsque la valeur IndicationRemoteConnect INDICATION_CODE est spécifiée dans le paramètre Indication de la fonction de rappel améliorée.

Parameters.ConfigRequest

Structure qui contient des paramètres pour la valeur IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.CurrentParams

Structure CHANNEL_CONFIG_PARAMETERS_ENHANCED qui contient les paramètres du canal actuel. Cette valeur n’est valide que si le canal a été ouvert précédemment et est maintenant en cours de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigRequest.RequestedParams

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

Parameters.ConfigRequest.ResponseParams

Structure CHANNEL_CONFIG_PARAMETERS_ENHANCED qui contient les paramètres auxquels le pilote de profil répond à la demande de configuration.

Parameters.ConfigRequest.Response

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

Drapeau Description
CONFIG_STATUS_SUCCESS La demande de configuration a réussi.
CONFIG_STATUS_DISCONNECT La demande de configuration a échoué, car la connexion L2CAP améliorée a été déconnectée.
CONFIG_STATUS_INVALID_PARAMETER La demande de configuration a échoué, car un paramètre non valide a été transmis 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 des paramètres pour la valeur IndicationRemoteConfigResponse INDICATION_CODE.

Parameters.ConfigResponse.CurrentParams

Structure CHANNEL_CONFIG_PARAMETERS_ENHANCED qui contient les paramètres du canal actuel.

Cette valeur n’est valide que si le canal a été ouvert précédemment et est maintenant en cours de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur IndicationRemoteConfigRequest INDICATION_CODE.

Parameters.ConfigResponse.RequestedParams

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

Parameters.ConfigResponse.RejectedParams

Structure CHANNEL_CONFIG_PARAMETERS_ENHANCED 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 répondant.

Parameters.ConfigResponse.NumUnknownTypes

Nombre de types non reconnus dans le membre UnknownTypes.

Parameters.ConfigResponse.NewRequestParams

Structure CHANNEL_CONFIG_PARAMETERS_ENHANCED qui contient les paramètres de la fonction de rappel améliorée à renvoyer une fois la réponse retournée à partir de l’appareil distant.

Parameters.ConfigResponse.Response

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

Drapeau Description
CONFIG_STATUS_SUCCESS La demande de configuration a réussi.
CONFIG_STATUS_DISCONNECT La demande de configuration a échoué, car la connexion L2CAP améliorée a été déconnectée.
CONFIG_STATUS_INVALID_PARAMETER La demande de configuration a échoué, car un paramètre non valide a été transmis 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 des paramètres pour la valeur IndicationFreeExtraOptions INDICATION_CODE.

Parameters.FreeExtraOptions.NumExtraOptions

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

Parameters.FreeExtraOptions.ExtraOptions

Options supplémentaires.

Parameters.Disconnect

Structure qui contient les paramètres de la valeur IndicationRemoteDisconnect INDICATION_CODE.

Parameters.Disconnect.Reason

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

Parameters.Disconnect.CloseNow

Valeur booléenne utilisée par un pilote de profil pour notifier la pile des pilotes Bluetooth pour fermer la connexion L2CAP. Définissez ce membre sur TRUE pour notifier la pile des pilotes Bluetooth pour fermer la connexion. Sinon, définissez-le sur FALSE pour maintenir la connexion ouverte.

Parameters.RecvPacket

Structure qui contient les paramètres de la valeur IndicationRecvPacket INDICATION_CODE.

Parameters.RecvPacket.PacketLength

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

Parameters.RecvPacket.TotalQueueLength

Nombre de paquets à traiter sur la connexion L2CAP.

Parameters.Reserved

Membre réservé. N’utilisez pas.

Exigences

Exigence Valeur
client minimum pris en charge Versions :_Supported dans Windows 8 et versions ultérieures de Windows
d’en-tête bthddi.h (include Bthddi.h)