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 控制器驱动程序在断开引脚后会保留引脚的配置。 有关详细信息，请参阅“备注”。

注解

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

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

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

要求

要求 值
最低受支持的客户端 从 Windows 8 开始支持。
标头 gpioclx.h

另请参阅

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisconnectIoPins

CLIENT_QueryControllerBasicInformation

GPIO_CONNECT_IO_PINS_MODE