Share via

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

  • Статья

Структура GPIO_DISABLE_INTERRUPT_PARAMETERS описывает контакт прерывания ввода-вывода общего назначения (GPIO) для отключения.

Синтаксис

typedef struct _GPIO_DISABLE_INTERRUPT_PARAMETERS {
  BANK_ID                      BankId;
  PIN_NUMBER                   PinNumber;
  GPIO_DISABLE_INTERRUPT_FLAGS Flags;
} GPIO_DISABLE_INTERRUPT_PARAMETERS, *PGPIO_DISABLE_INTERRUPT_PARAMETERS;

Члены

BankId

Идентификатор банка контактов GPIO, который содержит контакт прерывания GPIO для отключения. Если N — количество банков в контроллере GPIO, BankId — это целое число в диапазоне от 0 до N–1. Расширение платформы GPIO (GpioClx) ранее получило количество банков в контроллере из функции обратного вызова события CLIENT_QueryControllerBasicInformation . Дополнительные сведения см. в разделе Примечания в CLIENT_CONTROLLER_BASIC_INFORMATION.

PinNumber

Номер пин-кода относительно банка. Если N — число контактов в этом банке, PinNumber — это целое число в диапазоне от 0 до N–1. GpioClx ранее получил количество контактов в каждом банке из функции обратного вызова события CLIENT_QueryControllerBasicInformation . Дополнительные сведения см. в описании участника NumberOfPinsPerBank в CLIENT_CONTROLLER_BASIC_INFORMATION.

Flags

Набор флагов для управления операцией прерывания и отключения. Бит флага RetryDisableOnFailure указывает, что предыдущий вызов CLIENT_DisableInterrupt для отключения того же контакта завершился сбоем. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Параметр DisableParameters функции обратного вызова события CLIENT_DisableInterrupt является указателем на структуру, выделенную вызывающим объектом GPIO_DISABLE_INTERRUPT_PARAMETERS .

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

После сбоя CLIENT_DisableInterrupt вызова GpioClx может повторить вызов один или несколько раз. Во время каждой повторной попытки GpioClx устанавливает флаг RetryDisableOnFailure , чтобы указать, что предыдущий вызов завершился сбоем. Функция CLIENT_DisableInterrupt может реагировать на этот флаг, выполнив дополнительные действия, чтобы повысить вероятность успешного отключения прерывания.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 8.
Верхняя часть gpioclx.h

См. также раздел

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_DisableInterrupt

CLIENT_QueryControllerBasicInformation