RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER结构(reshub.h)

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 成员的定义使用 ntdef.h 头文件定义为 1 的ANYSIZE_ARRAY常量。 有关详细信息,请参阅“备注”。

言论

ConnectionPropertiesRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 结构的成员包含目标设备的串行总线连接描述符的第一个字节。 描述符中的剩余字节紧跟内存中的此成员。 为 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 结构的代码示例,请参阅 如何获取设备的连接设置。

要求

要求 价值
最低支持的客户端 从 Windows 8 开始支持。
标头 reshub.h

另请参阅

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR