INDICATION_PARAMETERS_ENHANCED structure (bthddi.h)

La structure INDICATION_PARAMETERS_ENHANCED est passée en tant que paramètre Parameters à la fonction de rappel L2CAP améliorée d’un 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 à l’appareil distant. Ce handle est valide uniquement 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) qui est 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 les paramètres de la valeur INDICATION_CODE IndicationRemoteConfigRequest .

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é précédemment ouvert et est en cours de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur de INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigRequest.RequestedParams

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

Parameters.ConfigRequest.ResponseParams

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

Parameters.ConfigRequest.Response

Indicateur qui indique la 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 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é 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 INDICATION_CODE IndicationRemoteConfigResponse .

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é précédemment ouvert et est en cours de configuration. Ce membre est utilisé lorsque la fonction de rappel spécifie la valeur de INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigResponse.RequestedParams

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

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 qui répond.

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 la 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 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é 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 INDICATION_CODE IndicationFreeExtraOptions .

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 INDICATION_CODE IndicationRemoteDisconnect .

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 des pilotes Bluetooth de fermer la connexion. Sinon, définissez-la sur FALSE pour que la connexion reste ouverte.

Parameters.RecvPacket

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

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 via la connexion L2CAP.

Parameters.Reserved

Membre réservé. Ne pas utiliser.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Versions :_Supported dans Windows 8 et versions ultérieures de Windows
En-tête	bthddi.h (inclure Bthddi.h)