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 |