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