CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 结构 (gpioclx.h)

  • 项目

CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 结构包含一组通用 I/O (GPIO) 控制器属性，这些属性由 GPIO 框架扩展 (GpioClx) 请求。

语法

typedef struct _CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT {
  USHORT Version;
  USHORT Size;
  union {
    CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT BankPowerInformation;
    struct {
      ULONG ResourceMapping[ANYSIZE_ARRAY];
    } BankInterruptBinding;
    struct {
      BOOLEAN Mapping[ANYSIZE_ARRAY];
    } ControllerFunctionBankMapping;
  };
} CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT, *PCLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT;

成员

Version

指定此结构的版本号。

Size

指定此结构的大小（以字节为单位）。

BankPowerInformation

一个CLIENT_QUERY_BANK_POWER_INFORMATION_OUTPUT结构，包含由相应CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT结构的 BankPowerInformation.BankId 成员标识的 GPIO 库的电源属性。

BankInterruptBinding

一个结构，包含有关将中断资源绑定到 GPIO 库的信息。

BankInterruptBinding.ResourceMapping[ANYSIZE_ARRAY]

中断资源编号的数组。 数组中的元素数等于 GPIO 库的数目。 如果 N 是 GPIO 控制器中的库数，则银行的编号为 0 到 N-1。 数组的元素 0 包含绑定到 bank 0 的中断资源编号，元素 1 包含绑定到库 1 的中断资源编号，依此依序排列。 不能将多个中断资源绑定到 GPIO 库，但两个或多个银行可能共享一个中断资源。 如果 bank 未绑定到中断资源，则相应的数组元素将设置为 GPIO_BANK_INTERRUPT_BINDING_RESERVED_INDEX (0xffff) 。

中断资源由其资源编号标识，该资源号是CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT结构的 BankInterruptBinding 成员中 ResourcesTranslated 或 ResourcesRaw 资源列表中的资源的索引。 如果列表包含 M 资源，则资源的编号为 0 到 M-1。 只有与资源列表中的中断资源对应的资源编号才能显示在 ResourceMapping 数组中。

ControllerFunctionBankMapping

一个结构，包含有关 GPIO 库的信息，该信息必须完全位于 F0 () 电源状态来处理 I/O 控制请求 (IOCTL) 。

ControllerFunctionBankMapping.Mapping[ANYSIZE_ARRAY]

一个 BOOLEAN 值的数组，指示将所需的 F0 电源状态映射到 GPIO 库。 数组中的元素数等于 GPIO 库的数目。 如果 N 是 GPIO 控制器中的库数，则银行的编号为 0 到 N-1。 数组的元素 0 包含 bank 0 的映射，元素 1 包含 bank 1 的映射，依此。 如果元素为 TRUE，则相应的 GPIO 库必须处于 F0 电源状态才能处理 IOCTL。 如果元素为 FALSE，则相应的库不需要处于 F0 电源状态。

注解

未命名的联合包含各种类型的属性请求的输出信息。 相应CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT结构的 RequestType 成员确定使用其中哪些成员。

CLIENT_QuerySetControllerInformation 函数的可选 OutputBuffer 参数是指向调用方分配的CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT结构的指针。 如果 OutputBuffer 为非 NULL，则该函数会将请求的属性信息写入此结构。

要求

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

另请参阅