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