GPIO_CONNECT_IO_PINS_PARAMETERS结构（gpioclx.h）

项目
02/07/2025

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 微秒为单位的反击时间。例如，将 debounce 时间指定为 584 毫秒。如果输入信号由机械开关生成，开关中的金属接触往往在开关打开或关闭后短暂反弹。反转时间是输入信号的最小时间必须保持稳定，然后才能将信号解释为有效的高或低级别。

DriveStrength

GPIO 引脚的驱动器强度（单位为 10 微采样）。例如，驱动器强度为 1.21 毫米，指定为 121。

VendorData

指向调用方分配的缓冲区的指针，其中包含从硬件平台的 ACPI 固件获取的特定于供应商的数据。此数据从 GPIO 资源描述符的 VendorData 字段中复制，该字段描述外围设备与 GPIO 控制器上的一组 GPIO 引脚之间的数据 I/O 连接。此成员是可选的，如果固件未为此连接提供特定于供应商的数据，则设置为 NULL。

VendorDataLength

VendorData 成员指向的数据缓冲区的大小（以字节为单位）。如果 VendorData 为 NULL，VendorDataLength 设置为零。

ConnectFlags

一组用于控制 GPIO 引脚配置的标志。当前没有为此成员定义任何标志。