структура 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