RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构 (reshub.h)

项目
08/07/2023

RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构包含连接到串行总线 (I2C、SPI 或 UART) 的目标设备的连接属性。

语法

typedef struct _RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER {
  ULONG Version;
  ULONG PropertiesLength;
  UCHAR ConnectionProperties[ANYSIZE_ARRAY];
} RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, *PRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER;

成员

Version

此结构的版本号。此成员设置为 reshub.h 头文件中定义的RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION常量。

PropertiesLength

以 ConnectionProperties 数组的元素 0 开头的串行总线连接描述符的大小（以字节为单位）。

ConnectionProperties[ANYSIZE_ARRAY]

串行总线连接描述符的第一个字节。此字节紧跟描述符的剩余字节。 PropertiesLength 成员指定描述符占用的总字节数。 ConnectionProperties 成员的定义使用 ANYSIZE_ARRAY 常量，Ntdef.h 头文件将其定义为 1。有关详细信息，请参阅“备注”。

注解

RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构的 ConnectionProperties 成员包含目标设备的串行总线连接描述符的第一个字节。描述符中的剩余字节紧跟在内存中的此成员之后。为 RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构分配的缓冲区足够大，足以包含此结构以及超出结构末尾的串行总线连接描述符的剩余字节。

ACPI 5.0 规范中介绍了串行总线连接描述符的格式。为方便起见，Reshub.h 头文件定义了 PNP_SERIAL_BUS_DESCRIPTOR 结构，使驱动程序能够访问此描述符中的值。

SPB 控制器驱动程序调用 SpbTargetGetConnectionParameters 方法以获取简单外围总线上目标设备的连接参数， (通常为 I²C 或 SPI) 。此方法将连接参数写入 SPB_CONNECTION_PARAMETERS 结构，并且此结构的 ConnectionParameters 成员是指向 RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构的指针。

有关使用 RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构的代码示例，请参阅如何获取设备的连接设置。