CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 结构 (gpioclx.h)

  • 项目

CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT 结构包含对常规用途 I/O (GPIO) 控制器的硬件属性的请求。

语法

typedef struct _CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT {
  CLIENT_CONTROLLER_QUERY_SET_REQUEST_TYPE RequestType;
  USHORT                                   Size;
  ULONG                                    Flags;
  union {
    struct {
      BANK_ID BankId;
    } BankPowerInformation;
    struct {
      WDFCMRESLIST ResourcesTranslated;
      WDFCMRESLIST ResourcesRaw;
      USHORT       TotalBanks;
    } BankInterruptBinding;
    struct {
      PVOID  InputBuffer;
      SIZE_T InputBufferSize;
      SIZE_T OutputBufferSize;
      USHORT TotalBanks;
    } ControllerFunctionBankMapping;
  };
} CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT, *PCLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT;

成员

RequestType

所请求的属性信息的类型。 此成员设置为 CLIENT_CONTROLLER_QUERY_SET_REQUEST_TYPE 枚举值。

Size

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

Flags

一组标志位，用于提供有关 RequestType 成员指示的属性请求类型的其他信息。 当前未为 Flags 成员定义任何标志 。

BankPowerInformation

一个结构，包含有关正在请求其电源属性的 GPIO 库的信息。

BankPowerInformation.BankId

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

BankInterruptBinding

一个结构，包含有关分配给 GPIO 控制器的中断资源的信息。

BankInterruptBinding.ResourcesTranslated

框架资源列表对象的句柄，该对象标识即插即用管理器已分配给设备的已转换硬件资源。

BankInterruptBinding.ResourcesRaw

框架资源列表对象的句柄，该对象标识即插即用管理器分配给设备的原始硬件资源。

BankInterruptBinding.TotalBanks

GPIO 控制器中的库数。 如果调用方提供指向此结构的非 NULL 指针，则此成员指示调用方分配CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT结构中 BankInterruptBinding.ResourceMapping 数组的预期长度。

ControllerFunctionBankMapping

包含 I/O 控制请求 (IOCTL) 的信息的结构。

ControllerFunctionBankMapping.InputBuffer

指向 IOCTL 的输入缓冲区的指针。

ControllerFunctionBankMapping.InputBufferSize

IOCTL 的输入缓冲区的大小（以字节为单位）。

ControllerFunctionBankMapping.OutputBufferSize

IOCTL 的输出缓冲区的大小（以字节为单位）。

ControllerFunctionBankMapping.TotalBanks

GPIO 控制器中的库数。 如果调用方提供指向此结构的非 NULL 指针，则此成员指示调用方分配的CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT结构中 ControllerFunctionBankMapping.Mapping 数组的预期长度。

注解

未命名的联合包含各种类型的属性请求的输入信息。 RequestType 成员确定使用此联合的哪个成员。 下表显示了对应于每个有效 RequestType 值的联合成员。

RequestType 值 联合成员
QueryBankPowerInformation BankPowerInformation
QueryBankInterruptBindingInformation BankInterruptBinding
QueryControllerFunctionBankMappingInformation ControllerFunctionBankMapping

CLIENT_QuerySetControllerInformation 函数的 InputBuffer 参数是指向CLIENT_CONTROLLER_QUERY_SET_INFORMATION_INPUT结构的指针。

要求

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

另请参阅