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