GPIO_READ_PINS_PARAMETERS structure (gpioclx.h)
The GPIO_READ_PINS_PARAMETERS structure describes a read operation on a group of general-purpose I/O (GPIO) pins.
Syntax
typedef struct _GPIO_READ_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
ULONG PinCount;
PVOID Buffer;
GPIO_READ_PINS_FLAGS Flags;
PVOID Reserved;
} GPIO_READ_PINS_PARAMETERS, *PGPIO_READ_PINS_PARAMETERS;
Members
BankId
The identifier for the bank of GPIO pins that contains the pins to read. If N is the number of banks in the GPIO controller, BankId is an integer in the range 0 to N–1. The GPIO framework extension (GpioClx) previously obtained the number of banks in the controller from the CLIENT_QueryControllerBasicInformation event callback function. For more information, see Remarks in CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumberTable
A pointer to an array of bank-relative PIN_NUMBER values. Each array element specifies the number of a GPIO pin to read from. If this bank has N pins, the pins are numbered 0 to N–1. The number of elements in this array is specified by the PinCount member.
PinCount
The number of elements in the PinNumberTable array.
Buffer
A pointer to a buffer to hold the values that the GPIO controller driver reads from the GPIO pins that are specified by the PinNumberTable array. Array element 0 specifies the GPIO pin whose value is saved to bit 0 (the least significant bit) in the buffer, array element 1 specifies the GPIO pin whose value is saved to bit 1 in the buffer, and so on.
Flags
A set of flags to control the GPIO pin read operation. If the WriteConfiguredPins flag bit is set, the GPIO controller driver can read from a GPIO pin that is configured for write operations.
Reserved
Reserved for system use.
Remarks
The ReadParameters parameter of the CLIENT_ReadGpioPins event callback function is a pointer to a caller-allocated GPIO_READ_PINS_PARAMETERS structure. All of the pins that this function reads are part of the same bank of GPIO pins.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported starting with Windows 8. |
| Header | gpioclx.h |
See also
CLIENT_CONTROLLER_BASIC_INFORMATION