structure SPB_CONNECTION_PARAMETERS (spbcx.h)

Article
02/07/2025

La structure SPB_CONNECTION_PARAMETERS contient les paramètres de connexion d’un appareil cible sur un bus périphérique simple.

Syntaxe

typedef struct _SPB_CONNECTION_PARAMETERS {
  USHORT Size;
  PCWSTR ConnectionTag;
  PVOID  ConnectionParameters;
} SPB_CONNECTION_PARAMETERS, *PSPB_CONNECTION_PARAMETERS;

Membres

Size

Taille, en octets, de cette structure. La méthode SpbTargetGetConnectionParameters utilise la valeur Size pour déterminer la version de cette structure utilisée. Utilisez la fonction SPB_CONNECTION_PARAMETERS_INIT pour initialiser ce membre. Pour plus d’informations, consultez la section Remarques suivante.

ConnectionTag

Pointeur vers la balise de connexion pour cette cible. La balise de connexion est une chaîne opaque qui contient un ID de connexion qui identifie la connexion de l’appareil cible au bus. Pour plus d’informations, consultez ID de connexion pour SPB-Connected périphériques.

ConnectionParameters

Pointeur vers les paramètres de connexion de cette cible. Ce membre pointe vers une mémoire tampon qui contient les paramètres spécifiques à la cible que le pilote du contrôleur SPB doit communiquer avec la cible. Pour plus d’informations, consultez la section Remarques suivante.

Remarques

Cette structure contient des informations sur la connexion d’un appareil cible au bus. Lorsqu’un client (pilote périphérique) ouvre une connexion logique à l’appareil cible, le pilote du contrôleur SPB récupère les paramètres de connexion de l’appareil et stocke ces paramètres. Plus tard, en réponse à une demande d’E/S du client vers l’appareil, le pilote du contrôleur SPB utilise les paramètres de connexion pour configurer le contrôleur pour accéder à l’appareil via le bus.

Par exemple, les paramètres de connexion d’un appareil sur un bus I2C incluent les éléments suivants :

Adresse relative du bus de l’appareil cible.
Nombre de bits d’adresse à utiliser pour accéder à l’appareil cible.
Fréquence d’horloge du bus à utiliser pour accéder à l’appareil cible.

Le ConnectionParameters membre de la structure SPB_CONNECTION_PARAMETERS est un pointeur vers une mémoire tampon qui contient les paramètres de connexion d’un appareil cible sur le bus. Pour obtenir un exemple de code qui utilise les ConnectionParameters membre pour obtenir ces paramètres de connexion, consultez Comment obtenir les paramètres de connexion d’un appareil.

Appelez la méthode SpbTargetGetConnectionParameters pour obtenir les paramètres de connexion d’un handle SPBTARGET qui représente l’appareil cible. Cette méthode écrit les paramètres de connexion dans une structure SPB_CONNECTION_PARAMETERS fournie par l’appelant. Avant de passer cette structure à SpbTargetGetConnectionParameters, initialisez la structure en appelant la fonction SPB_CONNECTION_PARAMETERS_INIT.

Pour ouvrir une connexion au nom d’un client (pilote périphérique), l’extension de framework SPB (SpbCx) appelle la fonction de rappel EvtSpbTargetConnect de votre pilote de contrôleur SPB. Pour fermer la connexion, SpbCx appelle la fonction de rappel EvtSpbTargetDisconnect du pilote du contrôleur SPB. Un pilote de contrôleur SPB appelle généralement SpbTargetGetConnectionParameters à partir de la fonction EvtSpbTargetConnect du pilote.