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

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

Синтаксис

typedef struct _GPIO_MASK_INTERRUPT_PARAMETERS {
  BANK_ID BankId;
  ULONG64 PinMask;
  ULONG64 FailedMask;
} GPIO_MASK_INTERRUPT_PARAMETERS, *PGPIO_MASK_INTERRUPT_PARAMETERS;

Члены

BankId

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

PinMask

64-разрядная маска, указывающая, какие закрепления прерываний следует маскировать в указанном банке. Эта маска влияет только на контакты GPIO, настроенные как входные данные запроса прерывания. Бит в маске, который имеет значение 1, определяет контакт, который должен быть маскирован. Все остальные биты в маске имеют значение 0. Если N — это количество контактов в этом банке, они нумеруются от 0 до N–1. Бит 0 (наименьший значимый бит) в маске представляет закрепления 0, бит 1 — контакт 1 и т. д.

FailedMask

64-разрядная маска, идентифицирующая контакты GPIO, которые не удалось маскировать. Если драйверу контроллера GPIO не удается замаскировать бит, указанный в элементе PinMask , драйвер устанавливает соответствующий бит в элементе FailedMask , чтобы отметить этот сбой. Если все контакты, указанные в PinMask , успешно маскируются, драйвер устанавливает значение FailedMask равным нулю. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Параметр MaskParameters функции обратного вызова события CLIENT_MaskInterrupts является указателем на структуру, выделенную вызывающим объектом GPIO_MASK_INTERRUPT_PARAMETERS . Эта функция влияет только на контакты GPIO, настроенные как входные данные прерывания и которые являются частью указанного банка контактов GPIO.

Ожидается, что контроллеры GPIO с сопоставленными в памяти регистрами всегда будут успешно устанавливать для маски прерывания запрошенное значение. Элемент FailedMask в основном предназначен для использования контроллерами GPIO, которые не сопоставлены с памятью.

Требования

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

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

CLIENT_CONTROLLER_BASIC_INFORMATION

CLIENT_MaskInterrupts

CLIENT_QueryControllerBasicInformation