GPIO_CONNECT_IO_PINS_PARAMETERS 結構 (gpioclx.h)

發行項
02/26/2024

GPIO_CONNECT_IO_PINS_PARAMETERS 結構描述一組一般用途 I/O (GPIO) 針腳的邏輯連線，並指定是否要將這些針腳設定為數據輸入或輸出。

語法

typedef struct _GPIO_CONNECT_IO_PINS_PARAMETERS {
  BANK_ID                    BankId;
  PPIN_NUMBER                PinNumberTable;
  USHORT                     PinCount;
  GPIO_CONNECT_IO_PINS_MODE  ConnectMode;
  UCHAR                      PullConfiguration;
  USHORT                     DebounceTimeout;
  USHORT                     DriveStrength;
  PVOID                      VendorData;
  ULONG                      VendorDataLength;
  GPIO_CONNECT_IO_PINS_FLAGS ConnectFlags;
} GPIO_CONNECT_IO_PINS_PARAMETERS, *PGPIO_CONNECT_IO_PINS_PARAMETERS;

成員

BankId

包含 GPIO 針腳之銀行的標識碼。如果 M 是 GPIO 控制器中的銀行數目， BankId 是範圍 0 到 M–1 的整數。 GPIO 架構延伸模組 (GpioClx) 先前從 CLIENT_QueryControllerBasicInformation 事件回呼函式取得控制器中的銀行數目。如需詳細資訊，請參閱 CLIENT_CONTROLLER_BASIC_INFORMATION 中的。

PinNumberTable

PIN_NUMBER值的陣列指標。每個陣列元素會指定要連接的 GPIO 針腳數目。如果 N 是此銀行中的針腳數目，則針腳編號為 0 到 N–1。這個陣列中的元素數目是由 PinCount 成員指定。

PinCount

PinNumberTable 陣列中的元素數目。

ConnectMode

新連線中的 GPIO 針腳是否應設定為輸入或輸出。此參數的值是只讀連線的 ConnectModeInput、寫入連線的 ConnectModeOutput，以及 (ConnectModeInput ConnectModeOutput | ) 讀取/寫入連線。如需詳細資訊，請參閱 GPIO_CONNECT_IO_PINS_MODE。

PullConfiguration

GPIO 針腳是向上或下拉式的。此成員通常會設定為下列其中一個系統定義的常數：

GPIO_PIN_PULL_CONFIGURATION_PULLDEFAULT
GPIO_PIN_PULL_CONFIGURATION_PULLUP
GPIO_PIN_PULL_CONFIGURATION_PULLDOWN
GPIO_PIN_PULL_CONFIGURATION_PULLNONE

如果這些常數都未適當描述針腳組態，這個成員可以設定為範圍 128-255 中的廠商定義常數。如需這些常數的詳細資訊，請參閱 GPIO_PIN_PULL_CONFIGURATION_XXX。

DebounceTimeout

以 10 微秒為單位的反動時間。例如，將反轉時間 5.84 毫秒指定為 584。如果機械開關產生輸入訊號，開關中的金屬接觸通常會在開關開啟或關閉之後短暫地彈跳。反轉時間是輸入訊號層級必須保持穩定的時間下限，才能將訊號解譯為有效的高或低層級。

DriveStrength

GPIO 針腳的磁碟驅動器強度，單位為10個微取樣器。例如，1.21 毫秒的磁碟驅動器強度會指定為121。

VendorData

呼叫端配置的緩衝區指標，其中包含從硬體平臺的ACPI韌體取得的廠商特定數據。此數據會從 GPIO 資源描述元的 VendorData 字段複製，描述周邊裝置與 GPIO 控制器上一組 GPIO 針腳之間的數據 I/O 連線。這個成員是選擇性的，如果韌體未為此連線提供廠商特定數據，則會設定為 NULL。

VendorDataLength

VendorData 成員所指向之數據緩衝區的大小，以位元組為單位。如果 VendorData 為 NULL，VendorDataLength 會設定為零。

ConnectFlags

一組旗標，可控制 GPIO 針腳的組態。此成員目前未定義旗標。