SPB_CONNECTION_PARAMETERS结构（spbcx.h）

项目
02/07/2025

SPB_CONNECTION_PARAMETERS 结构包含简单外围总线上目标设备的连接参数。

语法

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

成员

Size

此结构的大小（以字节为单位）。 SpbTargetGetConnectionParameters 方法使用 Size 值来确定正在使用哪种版本的此结构。使用 SPB_CONNECTION_PARAMETERS_INIT 函数初始化此成员。有关详细信息，请参阅以下“备注”部分。

ConnectionTag

指向此目标的连接标记的指针。连接标记是一个不透明的字符串，其中包含一个连接 ID，用于标识目标设备与总线的连接。有关详细信息，请参阅 SPB-Connected 外围设备连接 ID。

ConnectionParameters

指向此目标的连接参数的指针。此成员指向一个内存缓冲区，该缓冲区包含 SPB 控制器驱动程序需要与目标通信的目标特定参数。有关详细信息，请参阅以下“备注”部分。

言论

此结构包含有关目标设备与总线的连接的信息。当客户端（外围驱动程序）打开与目标设备的逻辑连接时，SPB 控制器驱动程序将检索设备的连接设置并存储这些设置。稍后，为了响应从客户端到设备的 I/O 请求，SPB 控制器驱动程序使用连接设置将控制器配置为通过总线访问设备。

例如，I2C 总线上设备的连接设置包括：

目标设备的总线相对地址。
用于访问目标设备的地址位数。
用于访问目标设备的总线时钟频率。

SPB_CONNECTION_PARAMETERS 结构的 ConnectionParameters 成员是指向包含总线上目标设备的连接设置的缓冲区的指针。有关使用 ConnectionParameters 成员获取这些连接参数的代码示例，请参阅如何获取设备的连接设置。

调用 SpbTargetGetConnectionParameters 方法以获取表示目标设备的 SPBTARGET 句柄的连接参数。此方法将连接参数写入调用方提供的 SPB_CONNECTION_PARAMETERS 结构。将此结构传递给 SpbTargetGetConnectionParameters之前，请通过调用 SPB_CONNECTION_PARAMETERS_INIT 函数初始化结构。

若要代表客户端（外围驱动程序）打开连接，SPB 框架扩展（SpbCx）调用 SPB 控制器驱动程序的 EvtSpbTargetConnect 回调函数。若要关闭连接，SpbCx 调用 SPB 控制器驱动程序的 EvtSpbTargetDisconnect 回调函数。 SPB 控制器驱动程序通常从驱动程序的 EvtSpbTargetConnectConnect 函数调用 SpbTargetGetConnectionParameters。