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 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 引脚配置的一组标志。当前未为此成员定义任何标志。