GPIO_DISCONNECT_IO_PINS_PARAMETERS结构（gpioclx.h）

GPIO_DISCONNECT_IO_PINS_PARAMETERS 结构描述要断开连接的一组通用 I/O（GPIO）引脚。

语法

typedef struct _GPIO_DISCONNECT_IO_PINS_PARAMETERS {
  BANK_ID                       BankId;
  PPIN_NUMBER                   PinNumberTable;
  ULONG                         PinCount;
  GPIO_CONNECT_IO_PINS_MODE     DisconnectMode;
  GPIO_DISCONNECT_IO_PINS_FLAGS DisconnectFlags;
} GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS;

成员

BankId

包含 GPIO 引脚的银行的标识符。如果 M 是 GPIO 控制器中的银行数，BankId 是 0 到 M–1 范围内的整数。 GPIO 框架扩展（GpioClx）以前从 CLIENT_QueryControllerBasicInformation 事件回调函数中获取控制器中的银行数。有关详细信息，请参阅 CLIENT_CONTROLLER_BASIC_INFORMATION中的备注。

PinNumberTable

指向PIN_NUMBER值的数组的指针。每个数组元素指定要断开连接的 GPIO 引脚的数目。如果 GPIO 控制器有 N 个引脚，则引脚编号为 0 到 N–1。此数组中的元素数由 PinCount 成员指定。

PinCount

PinNumberTable 数组中的元素数。

DisconnectMode

正在关闭的连接中的 GPIO 引脚是配置为输入还是输出。此成员的值是 ConnectModeInput 进行只读连接，ConnectModeOutput 用于写入连接，或者（ConnectModeInput | ConnectModeOutput）进行读/写连接。有关详细信息，请参阅 GPIO_CONNECT_IO_PINS_MODE。

DisconnectFlags

一组标志，用于控制 GPIO 引脚在关闭后的配置方式。如果设置了 PreserveConfiguration 标志位，则 GPIO 控制器驱动程序会在断开连接后保留引脚的配置。有关详细信息，请参阅“备注”。

言论

DisconnectParameters 参数到 CLIENT_DisconnectIoPins 事件回调例程是指向 GPIO_CONNECT_IO_PINS_PARAMETERS 结构的指针。

默认情况下，当 GPIO I/O 引脚断开连接时，GPIO 控制器驱动程序会以特定于平台的初始状态配置引脚。引脚通常配置为处于低功率状态，以减少电池负载。但是，可以使用 PreserveConfiguration 标志来替代此默认行为。该标志指示 GPIO 控制器驱动程序保留正在断开连接的 I/O 引脚的配置。

例如，外围设备驱动程序可能会打开与配置为输出的 GPIO I/O 引脚的逻辑连接，然后将位值 1 写入引脚。 PreserveConfiguration 标志使驱动程序无需更改引脚的输出级别即可关闭连接。稍后，如果驱动程序需要将引脚的输出级别从 1 更改为 0，驱动程序将打开与引脚的新连接。