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 成员指示的属性请求类型的其他信息。 当前未为 标志 成员定义任何标志。

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 控制器中的银行数。 此成员指示调用方分配 CLIENT_CONTROLLER_QUERY_SET_INFORMATION_OUTPUT 结构中 BankInterruptBinding.ResourceMapping 数组的预期长度(如果调用方为此结构提供非 NULL 指针)。

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

另请参阅