структура GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)
Структура GPIO_DISCONNECT_IO_PINS_PARAMETERS описывает набор закреплений ввода-вывода общего назначения (GPIO), которые должны быть отключены.
Синтаксис
typedef struct _GPIO_DISCONNECT_IO_PINS_PARAMETERS {
BANK_ID BankId;
PPIN_NUMBER PinNumberTable;
ULONG PinCount;
GPIO_CONNECT_IO_PINS_MODE DisconnectMode;
GPIO_DISCONNECT_IO_PINS_FLAGS DisconnectFlags;
} GPIO_DISCONNECT_IO_PINS_PARAMETERS, *PGPIO_DISCONNECT_IO_PINS_PARAMETERS;
Члены
BankId
Идентификатор банка, содержащего пин-коды GPIO. Если M является числом банков в контроллере GPIO, BankId является целым числом в диапазоне от 0 до M–1. Расширение платформы GPIO (GpioClx) ранее получило количество банков в контроллере из функции обратного вызова событий CLIENT_QueryControllerBasicInformation. Дополнительные сведения см. в разделе "Примечания" в CLIENT_CONTROLLER_BASIC_INFORMATION.
PinNumberTable
Указатель на массив значений PIN_NUMBER. Каждый элемент массива указывает число пин-кода GPIO для отключения от нее. Если контроллер GPIO имеет N-пины, пин-коды нумеруются от 0 до N–1. Число элементов в этом массиве определяется элементом PinCount.
PinCount
Количество элементов в массиве PinNumberTable.
DisconnectMode
Указывает, настроены ли закрытые контакты GPIO в качестве входных данных или выходных данных. Значение этого члена — ConnectModeInput для подключения только для чтения, ConnectModeOutput для подключения только для записи или (ConnectModeInput | ConnectModeOutput) для подключения чтения и записи. Дополнительные сведения см. в GPIO_CONNECT_IO_PINS_MODE.
DisconnectFlags
Набор флагов, управляющих настройкой пин-кодов GPIO после закрытия. Если установлен бит флага PreserveConfiguration, драйвер контроллера GPIO сохраняет конфигурацию контактов после отключения. Дополнительные сведения см. в разделе "Примечания".
Замечания
Параметр DisconnectParameters подпрограмме обратного вызова событий CLIENT_DisconnectIoPins — это указатель на структуру GPIO_CONNECT_IO_PINS_PARAMETERS.
По умолчанию при отключении пин-кода ввода-вывода GPIO драйвер контроллера GPIO настраивает пин-код в исходном состоянии для конкретной платформы. Пин-код обычно настраивается в состоянии низкой мощности, чтобы уменьшить нагрузку на батарею. Однако флаг PreserveConfiguration можно использовать для переопределения этого поведения по умолчанию. Флаг сообщает драйверу контроллера GPIO сохранить конфигурацию отключенных контактов ввода-вывода.
Например, драйвер периферийных устройств может открыть логическое подключение к пин-коду ввода-вывода GPIO, настроенному в качестве выходных данных, а затем записать битовое значение 1 в пин-код. Флаг PreserveConfiguration позволяет драйверу закрыть подключение без изменения уровня вывода пин-кода. Позже, если драйверу нужно изменить уровень вывода пин-кода с 1 до 0, драйвер открывает новое подключение к пин-коду.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Поддерживается начиная с Windows 8. |
| заголовка | gpioclx.h |
См. также
CLIENT_CONTROLLER_BASIC_INFORMATION