共用方式為

reshub.h) reshub.h PNP_SERIAL_BUS_DESCRIPTOR (結構

  • 發行項

PNP_SERIAL_BUS_DESCRIPTOR結構描述目標裝置與序列總線的實體連線， (I2C、SPI 或 UART) 。

語法

typedef struct _PNP_SERIAL_BUS_DESCRIPTOR {
  UCHAR  Tag;
  USHORT Length;
  UCHAR  RevisionId;
  UCHAR  ResourceSourceIndex;
  UCHAR  SerialBusType;
  UCHAR  GeneralFlags;
  USHORT TypeSpecificFlags;
  UCHAR  TypeSpecificRevisionId;
  USHORT TypeDataLength;
} PNP_SERIAL_BUS_DESCRIPTOR, *PPNP_SERIAL_BUS_DESCRIPTOR;

成員

Tag

序列總線類型。 此成員設定為0x8e序列總線 (I2C、SPI 或 UART) 連線。 如需詳細資訊，請參閱 ACPI 5.0 規格中序列總線連線描述元的描述。

Length

序列總線連接描述元的長度，以位元組為單位。 為了與 ACPI 5.0 規格一致，PNP_SERIAL_BUS_DESCRIPTOR 結構的 Length 成員中的位元組計數等於結構大小，減去結構開頭之 Tag 和 Length 成員中的三個字節，再加上結構後面的總線類型特定數據和資源來源字元串的位元組數目。 資源來源字串是必要欄位，其大小下限為兩個字節， (一個字元的資源來源名稱，以及終止的 null) 。 因此，最小有效 Length 值為 11。 如需詳細資訊，請參閱 ACPI 5.0 規格。

RevisionId

序列總線連接描述元的修訂標識碼。 這個成員會設定為 reshub.h 頭檔中定義的SERIAL_BUS_DESCRIPTOR_REVISION常數。

ResourceSourceIndex

保留供未來使用。 此成員未使用，且設定為零。

SerialBusType

序列總線類型。 此成員設定為 I2C) 1 (、SPI) 為 2 (，或 UART) 為 3 (。 其他值會保留供未來使用，或由硬體廠商定義。 如需詳細資訊，請參閱 ACPI 5.0 規格。

GeneralFlags

所有序列總線類型通用的旗標。 位 0 是次級模式旗標。 如果此位設定為 1，則總線控制器會起始此連線的通訊;否則，通訊是由目標裝置起始。 位 1 是取用者/產生者旗標，且一律設定為 1。 目前未定義其他旗標位。 如需詳細資訊，請參閱 ACPI 5.0 規格。

TypeSpecificFlags

序列總線類型特有的旗標。 針對 I2C 總線，如果連線使用 10 位位址，則會設定位 0;否則，連接會使用 7 位位址。 I2C 目前未定義其他旗標位。 如需詳細資訊，請參閱 ACPI 5.0 規格。

TypeSpecificRevisionId

此結構變體的修訂標識碼，用於由 Tag 成員指定的序列總線類型 (I2C、SPI 和 UART) 。 每個序列總線類型都會藉由新增總線類型特有的字段，來擴充 PNP_SERIAL_BUS_DESCRIPTOR 結構。 如需詳細資訊，請參閱 ACPI 5.0 規格。

TypeDataLength

在 PNP_SERIAL_BUS_DESCRIPTOR 結構之後，總線類型特定數據的長度，以位元組為單位。 這個長度值包含 TypeDataLength 成員結尾與資源來源字串開頭之間的數據，但不包含資源來源字串。 如需詳細資訊，請參閱 ACPI 5.0 規格。

備註

此結構會定義序列總線連線描述元中的數據欄位，如 ACPI 5.0 規格的 6.4.3.8.2 節所述。 此描述項描述連線到連線至序列總線的目標裝置的總線連線， (I2C、SPI 或 UART) 。

例如，針對 I2C 總線上的裝置， PNP_SERIAL_BUS_DESCRIPTOR 結構 (及其總線類型特定擴充功能) 指定裝置的總線位址、位址模式 (7 位或 10 位) ，以及存取裝置時執行總線時鐘的頻率。 如需示範 I2C 控制器驅動程式如何從 結構擷取此資訊的程式代碼範例，請參閱 如何取得裝置的連線設定。

Reshub.h 頭檔中 的PNP_SERIAL_BUS_DESCRIPTOR 結構定義前面會加上 Pshpack1.h 頭檔的 include 語句，這會將編譯程式設定為將相鄰結構成員封裝到位元組界限，而不會交錯間距。 接著，軟體可以將封裝的結構重疊在序列總線連接描述元的記憶體映射上，以存取此描述元的個別欄位。 結構的 USHORT 成員可能不會對齊記憶體中的偶數位節界限。 USHORT 成員中的位元組會以位元組尾順序儲存 x86、x64 和 ARM 處理器架構。

規格需求

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