RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER結構 (reshub.h)

發行項
03/01/2024

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