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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應