Skip to content

Latest commit

 

History

History
101 lines (70 loc) · 5.42 KB

ns-gpioclx-_gpio_disconnect_io_pins_parameters.md

File metadata and controls

101 lines (70 loc) · 5.42 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NS:gpioclx._GPIO_DISCONNECT_IO_PINS_PARAMETERS
_GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)
The GPIO_DISCONNECT_IO_PINS_PARAMETERS structure describes a set of general-purpose I/O (GPIO) pins that are to be disconnected.
gpio\gpio_disconnect_io_pins_parameters.htm
GPIO
02/15/2018
GPIO_DISCONNECT_IO_PINS_PARAMETERS structure
*PGPIO_DISCONNECT_IO_PINS_PARAMETERS, GPIO.gpio_disconnect_io_pins_parameters, GPIO_DISCONNECT_IO_PINS_PARAMETERS, GPIO_DISCONNECT_IO_PINS_PARAMETERS structure [Parallel Ports], PGPIO_DISCONNECT_IO_PINS_PARAMETERS, PGPIO_DISCONNECT_IO_PINS_PARAMETERS structure pointer [Parallel Ports], _GPIO_DISCONNECT_IO_PINS_PARAMETERS, gpioclx/GPIO_DISCONNECT_IO_PINS_PARAMETERS, gpioclx/PGPIO_DISCONNECT_IO_PINS_PARAMETERS
gpioclx.h
Windows
Supported starting with Windows 8.
Windows
GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS
_GPIO_DISCONNECT_IO_PINS_PARAMETERS
gpioclx/_GPIO_DISCONNECT_IO_PINS_PARAMETERS
PGPIO_DISCONNECT_IO_PINS_PARAMETERS
gpioclx/PGPIO_DISCONNECT_IO_PINS_PARAMETERS
GPIO_DISCONNECT_IO_PINS_PARAMETERS
gpioclx/GPIO_DISCONNECT_IO_PINS_PARAMETERS
APIRef
kbSyntax
HeaderDef
Gpioclx.h
_GPIO_DISCONNECT_IO_PINS_PARAMETERS
PGPIO_DISCONNECT_IO_PINS_PARAMETERS
GPIO_DISCONNECT_IO_PINS_PARAMETERS

_GPIO_DISCONNECT_IO_PINS_PARAMETERS structure

-description

The GPIO_DISCONNECT_IO_PINS_PARAMETERS structure describes a set of general-purpose I/O (GPIO) pins that are to be disconnected.

-struct-fields

-field BankId

The identifier for the bank that contains the GPIO pins. If M is the number of banks in the GPIO controller, BankId is an integer in the range 0 to M–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.

-field PinNumberTable

A pointer to an array of PIN_NUMBER values. Each array element specifies the number of a GPIO pin to disconnect from. If the GPIO controller has N pins, the pins are numbered 0 to N–1. The number of elements in this array is specified by the PinCount member.

-field PinCount

The number of elements in the PinNumberTable array.

-field DisconnectMode

Whether the GPIO pins in the connection that is being closed are configured as inputs or as outputs. The value of this member is ConnectModeInput for a read-only connection, ConnectModeOutput for a write-only connection, or (ConnectModeInput | ConnectModeOutput) for a read/write connection. For more information, see GPIO_CONNECT_IO_PINS_MODE.

-field DisconnectFlags

A set of flags that control how the GPIO pins are to be configured after they are closed. If the PreserveConfiguration flag bit is set, the GPIO controller driver preserves the configuration of the pins after they are disconnected. For more information, see Remarks.

-remarks

The DisconnectParameters parameter to the CLIENT_DisconnectIoPins event callback routine is a pointer to a GPIO_CONNECT_IO_PINS_PARAMETERS structure.

By default, when a GPIO I/O pin is disconnected, the GPIO controller driver configures the pin in a platform-specific initial state. The pin is typically configured in a low-power state to reduce the load on the battery. However, the PreserveConfiguration flag can be used to override this default behavior. The flag tells the GPIO controller driver to preserve the configuration of the I/O pins that are being disconnected.

For example, a peripheral device driver might open a logical connection to a GPIO I/O pin that is configured as an output, and then write a bit value of 1 to the pin. The PreserveConfiguration flag enables the driver to close the connection without altering the pin's output level. Later, if the driver needs to change the output level of the pin from 1 to 0, the driver opens a new connection to the pin.

-see-also

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisconnectIoPins

CLIENT_QueryControllerBasicInformation

GPIO_CONNECT_IO_PINS_MODE