structure INDICATION_PARAMETERS (bthddi.h)
La structure INDICATION_PARAMETERS est passée en tant que paramètre Paramètres de à 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
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
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 des paramètres pour 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 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 IndicationRemoteConfigRequestINDICATION_CODE.
Parameters.ConfigRequest.RequestedParams
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
Structure CHANNEL_CONFIG_PARAMETERS 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 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 IndicationRemoteConfigResponseINDICATION_CODE.
Parameters.ConfigResponse.CurrentParams
Structure CHANNEL_CONFIG_PARAMETERS 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 IndicationRemoteConfigRequestINDICATION_CODE.
Parameters.ConfigResponse.RequestedParams
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.ConfigResponse.RejectedParams
A *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 répondant.
Parameters.ConfigResponse.NumUnknownTypes
Nombre de types non reconnus dans le membre UnknownTypes.
Parameters.ConfigResponse.NewRequestParams
A *CHANNEL_CONFIG_PARAMETERS structure qui contient les paramètres de la fonction de rappel à 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 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 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 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 IndicationRecvPacketINDICATION_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.
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 des pilotes Bluetooth passe 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 des paramètres union.
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteDisconnect, la fonction de rappel doit utiliser le membre Disconnect des paramètres union.
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteConfigRequest, la fonction de rappel doit utiliser le membre ConfigRequest des paramètres de union.
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 la FreeExtraOptions membre du Parameters union.
Lorsque la pile de pilotes Bluetooth passe IndicationRemoteRecvPacket, la fonction de rappel doit utiliser le membre RecvPacket de l’union Parameters.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| d’en-tête | bthddi.h (include Bthddi.h) |