通过

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT回调函数 (gpioclx.h)

  • 项目

CLIENT_PreProcessControllerInterrupt 事件回调函数执行常规用途 I/O (GPIO) 中断的任何预处理，如果 ISR 计划稍后运行，则必须立即完成这些处理。

语法

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT GpioClientPreProcessControllerInterrupt;

NTSTATUS GpioClientPreProcessControllerInterrupt(
  [in] PVOID Context,
  [in] BANK_ID BankId,
       ULONG64 EnabledMask
)
{...}

参数

[in] Context

指向 GPIO 控制器驱动程序 的设备上下文的指针。

[in] BankId

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

EnabledMask

返回值

如果调用成功， CLIENT_PreProcessControllerInterrupt 函数将返回STATUS_SUCCESS。 否则，它将返回相应的错误代码。

注解

此回调函数是可选的。 仅当 GPIO 控制器驱动程序在 PASSIVE_LEVEL 执行大部分中断处理，但必须在 DIRQL 中对中断执行一些初始处理时，才实现此函数。

通常，GPIO 控制器驱动程序可以在 DIRQL 上访问内存映射的 GPIO 控制器，但只能在PASSIVE_LEVEL访问串行连接的 GPIO 控制器。 但是，如果某些串行连接的 GPIO 控制器延迟捕获中断状态位，直到 IRQL 降至PASSIVE_LEVEL，它们可能会丢失中断状态数据。 当 IRQL 稍后下降到 PASSIVE_LEVEL 时，GPIO 框架扩展 (GpioClx) 可以调用驱动程序的 CLIENT_QueryActiveInterrupts 回调函数来检索寄存器内容。

GPIO 控制器驱动程序指示它是否必须处理在 CLIENT_QueryControllerBasicInformation回调期间 传递给 GpioClx 的设备信息PASSIVE_LEVEL中断。 如果 GPIO 控制器是内存映射的，以便驱动程序可以在 DIRQL 上访问控制器的寄存器，则驱动程序会在驱动程序传递给 GpioClx 的 CLIENT_CONTROLLER_BASIC_INFORMATION 结构的 Flags 成员中设置 MemoryMappedController 标志位。 否则，驱动程序设置 MemoryMappedController = 0 以指示驱动程序必须在PASSIVE_LEVEL处理中断。 有关详细信息，请参阅 被动级别 ISR。

若要注册驱动程序的 CLIENT_PreProcessControllerInterrupt 回调函数，请调用 GPIO_CLX_RegisterClient 方法。 此方法接受指向包含CLIENT_PreProcessControllerInterrupt函数指针的GPIO_CLIENT_REGISTRATION_PACKET结构的指针作为输入参数。

示例

若要定义 CLIENT_PreProcessControllerInterrupt 回调函数，必须先提供一个函数声明，用于标识要定义的回调函数的类型。 Windows 为驱动程序提供了一组回调函数类型。 使用回调函数类型声明函数可帮助 驱动程序的代码分析、 静态驱动程序验证程序 (SDV) 和其他验证工具查找错误，这是为 Windows 操作系统编写驱动程序的要求。

例如，若要定义名为 MyEvtGpioPreProcessInterrupt的CLIENT_PreProcessControllerInterrupt回调函数，请使用 GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT 函数类型，如以下代码示例所示：

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT MyEvtGpioPreProcessInterrupt;

然后，按如下所示实现回调函数：

_Use_decl_annotations_
NTSTATUS
  MyEvtGpioPreProcessInterrupt(
    PVOID Context
    )
{ ... }

GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT函数类型在 Gpioclx.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations批注可确保使用应用于头文件中GPIO_CLIENT_PRE_PROCESS_CONTROLLER_INTERRUPT函数类型的注释。 有关函数声明要求的详细信息，请参阅 使用 KMDF 驱动程序的函数角色类型声明函数。 有关 Use_decl_annotations的详细信息，请参阅 批注函数行为。

要求

要求 值
最低受支持的客户端 支持从Windows 8开始。
目标平台 桌面
标头 gpioclx.h
IRQL 在 DIRQL 中调用。

另请参阅

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_RegisterClient