GPIO_DISABLE_INTERRUPT_PARAMETERS 结构 (gpioclx.h)

  • 项目

GPIO_DISABLE_INTERRUPT_PARAMETERS结构描述要禁用的常规用途 I/O (GPIO) 中断引脚。

语法

typedef struct _GPIO_DISABLE_INTERRUPT_PARAMETERS {
  BANK_ID                      BankId;
  PIN_NUMBER                   PinNumber;
  GPIO_DISABLE_INTERRUPT_FLAGS Flags;
} GPIO_DISABLE_INTERRUPT_PARAMETERS, *PGPIO_DISABLE_INTERRUPT_PARAMETERS;

成员

BankId

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

PinNumber

相对于银行的引脚编号。 如果 N 是此库中的数字引脚， 则 PinNumber 是 0 到 N–1 范围内的整数。 GpioClx 之前从 CLIENT_QueryControllerBasicInformation 事件回调函数中获取了每个库中的引脚数。 有关详细信息，请参阅 CLIENT_CONTROLLER_BASIC_INFORMATION 中的 NumberOfPinsPerBank 成员的说明。

Flags

一组用于控制中断禁用操作的标志。 RetryDisableOnFailure 标志位指示上一CLIENT_DisableInterrupt调用禁用同一引脚失败。 有关详细信息，请参阅“备注”。

注解

CLIENT_DisableInterrupt事件回调函数的 DisableParameters 参数是指向调用方分配的GPIO_DISABLE_INTERRUPT_PARAMETERS结构的指针。

内存映射 GPIO 控制器的 CLIENT_DisableInterrupt 函数应始终成功禁用中断。 但是，未进行内存映射的控制器 的 CLIENT_DisableInterrupt 函数必须向控制器发送 I/O 请求以禁用中断，并且此请求可能会失败。 如果请求未能禁用中断，则函数必须返回错误状态代码。

CLIENT_DisableInterrupt调用失败后，GpioClx 可能会重试调用一次或多次。 每次重试期间，GpioClx 都会设置 RetryDisableOnFailure 标志，以指示上一次调用失败。 CLIENT_DisableInterrupt 函数可能会通过采取其他步骤来响应此标志，以增加下一次尝试禁用中断成功的可能性。

要求

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

另请参阅

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation