структура GPIO_DISCONNECT_IO_PINS_PARAMETERS (gpioclx.h)

Статья
02/29/2024

Структура 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 сохраняет конфигурацию контактов после их отключения. Дополнительные сведения см. в подразделе "Примечания".

По умолчанию, когда контакт ввода-вывода GPIO отключен, драйвер контроллера GPIO настраивает контакт в исходном состоянии для конкретной платформы. Контакт обычно настраивается в низком энергопотреблении, чтобы снизить нагрузку на батарею. Однако флаг PreserveConfiguration можно использовать для переопределения этого поведения по умолчанию. Флаг указывает драйверу контроллера GPIO сохранить конфигурацию отключаемых контактов ввода-вывода.

Например, драйвер периферийного устройства может открыть логическое подключение к контакту ввода-вывода GPIO, настроенному в качестве выходных данных, а затем записать битовое значение 1 в контакт. Флаг PreserveConfiguration позволяет драйверу закрыть подключение, не изменяя уровень вывода контакта. Если позже драйверу потребуется изменить уровень вывода контакта с 1 на 0, драйвер открывает новое подключение к контакту.