функция обратного вызова GPIO_CLIENT_UNMASK_INTERRUPT (gpioclx.h)
Функция обратного вызова события CLIENT_UnmaskInterrupt расмаскивает прерывание в контакте ввода-вывода общего назначения (GPIO), настроенном в качестве входных данных прерывания.
Синтаксис
GPIO_CLIENT_UNMASK_INTERRUPT GpioClientUnmaskInterrupt;
NTSTATUS GpioClientUnmaskInterrupt(
[in] PVOID Context,
[in] PGPIO_ENABLE_INTERRUPT_PARAMETERS InterruptParameters
)
{...}
Параметры
[in] Context
Указатель на контекст устройства драйвера контроллера GPIO.
[in] InterruptParameters
Указатель на структуру GPIO_ENABLE_INTERRUPT_PARAMETERS , которая задает контакт GPIO и описывает атрибуты прерывания этого контакта.
Возвращаемое значение
Функция CLIENT_UnmaskInterrupt возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки.
Комментарии
Эта функция обратного вызова реализуется драйвером контроллера GPIO. Расширение платформы GPIO (GpioClx) вызывает эту функцию для отмены маски прерываний в контакте GPIO, настроенном в качестве входных данных запроса прерывания. Дополнительные сведения см. в разделе Маски прерываний GPIO.
Чтобы зарегистрировать функцию обратного вызова CLIENT_UnmaskInterrupt драйвера, вызовите метод GPIO_CLX_RegisterClient . Этот метод принимает в качестве входного параметра указатель на структуру GPIO_CLIENT_REGISTRATION_PACKET , содержащую указатель функции CLIENT_UnmaskInterrupt .
Функция CLIENT_UnmaskInterrupt вызывается из подпрограммы службы прерываний (ISR) в GpioClx. Этот ISR выполняется в PASSIVE_LEVEL или DIRQL в зависимости от сведений об устройстве, которые функция обратного вызова CLIENT_QueryControllerBasicInformation предоставляет GpioClx. Функция CLIENT_QueryControllerBasicInformation предоставляет сведения об устройстве в виде структуры CLIENT_CONTROLLER_BASIC_INFORMATION . Если бит флага MemoryMappedController задан в элементе Flags этой структуры, isR GpioClx выполняется в DIRQL и вызывает функцию CLIENT_UnmaskInterrupt в DIRQL. В противном случае ISR запускается в PASSIVE_LEVEL и вызывает функцию в PASSIVE_LEVEL. Дополнительные сведения об этом бите флага см. в разделах Необязательные и обязательные функции обратного вызова GPIO.
Примеры
Чтобы определить CLIENT_UnmaskInterrupt функцию обратного вызова, необходимо сначала предоставить объявление функции, определяющее тип определяемой функции обратного вызова. Windows предоставляет набор типов функций обратного вызова для драйверов. Объявление функции с помощью типов функций обратного вызова помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.
Например, чтобы определить CLIENT_UnmaskInterrupt функцию обратного вызова с именем MyEvtGpioUnmaskInterrupt, используйте тип функции GPIO_CLIENT_UNMASK_INTERRUPT, как показано в следующем примере кода:
GPIO_CLIENT_UNMASK_INTERRUPT MyEvtGpioUnmaskInterrupt;
Затем реализуйте функцию обратного вызова следующим образом:
_Use_decl_annotations_
NTSTATUS
MyEvtGpioUnmaskInterrupt(
PVOID Context,
PGPIO_ENABLE_INTERRUPT_PARAMETERS InterruptParameters
)
{ ... }
Тип функции GPIO_CLIENT_UNMASK_INTERRUPT определен в файле заголовка Gpioclx.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, применяемых к типу функции GPIO_CLIENT_UNMASK_INTERRUPT в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов KMDF. Дополнительные сведения о Use_decl_annotations см. в статье Поведение функции с заметками.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается начиная с Windows 8. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | gpioclx.h |
| IRQL | См. заметки. |