共用方式為


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常數。 如需詳細資訊,請參閱<備註>。

備註

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 結構的程式代碼範例,請參閱 如何取得裝置的連線設定

規格需求

需求
最低支援的用戶端 從 Windows 8 開始支援。
標頭 reshub.h

另請參閱

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR