CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT结构(gpioclx.h)

CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 结构包含 GPIO 框架扩展 (GpioClx) 请求的一组常规用途 I/O (GPIO) 控制器属性。

语法

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 银行,但两个或多个银行可能会共享中断资源。 如果银行未绑定到中断资源,则相应的数组元素设置为 GPIO_BANK_INTERRUPT_BINDING_RESERVED_INDEX(0xffff)。

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

ControllerFunctionBankMapping

包含有关 GPIO 银行的信息的结构,这些银行必须处于 F0(完全打开)电源状态才能处理 I/O 控制请求(IOCTL)。

ControllerFunctionBankMapping.Mapping[ANYSIZE_ARRAY]

布尔值的数组,指示所需的 F0 电源状态到 GPIO 银行的映射。 数组中的元素数等于 GPIO 银行的数量。 如果 N 是 GPIO 控制器中的银行数,则银行编号为 0 到 N–1。 数组的元素 0 包含银行 0 的映射,元素 1 包含银行 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

另请参阅