SPB_CONNECTION_PARAMETERS 结构 (spbcx.h)

项目
08/07/2023

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。有关详细信息，请参阅 Connection IDs for SPB-Connected Peripheral Devices（SPB 连接的外围设备的连接 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 控制器驱动程序通常从驱动程序的 EvtSpbTargetConnect 函数调用 SpbTargetGetConnectionParameters。