Заголовок hwnclx.h

Этот заголовок определяет программные интерфейсы, необходимые для обеспечения аппаратной поддержки компонентов уведомлений, таких как светодиодные индикаторы и механизмы вибрации. Эта поддержка предоставляется путем внедрения расширения класса Kernel-Mode Driver Framework (KMDF) специально для компонентов уведомлений оборудования, что позволяет быстро разрабатывать клиентские драйверы. Расширение класса KMDF по сути является драйвером KMDF, предоставляющим определенный набор функциональных возможностей для заданного класса устройств, аналогично драйверу порта в модели драйвера Windows (WDM). В этом разделе представлен обзор архитектуры расширения класса уведомлений оборудования. Дополнительные сведения о KMDF см. в разделе

Дополнительные сведения см. в разделе:

• Руководство по проектированию уведомлений оборудования

Hwnclx.h содержит следующие программные интерфейсы:

Функции

HwNProcessAddDevicePostDeviceCreate Создает очереди ввода-вывода. Он должен вызываться после вызова EVT_WDF_DRIVER_DEVICE_ADD функции обратного вызова драйвера клиента и создания объекта устройства.
HwNProcessAddDevicePreDeviceCreate Предоставляет обратные вызовы подготовки, выпуска и входа и выхода устройства в Windows Driver Foundation (WDF) для перехода устройства в разные состояния.
HwNRegisterClient Регистрирует драйвер клиента уведомлений оборудования и его функции обратного вызова с расширением класса.
HwNUnregisterClient Отменяет регистрацию драйвера клиента уведомлений оборудования и его функций обратного вызова с помощью расширения класса. Эта функция должна вызываться при выгрузке драйвера клиента.

Функции обратного вызова

HWN_CLIENT_GET_STATE Реализуется драйвером клиента для получения состояния компонента уведомления оборудования. Он вызывается, когда пользователь запрашивает сведения о состоянии.
HWN_CLIENT_INITIALIZE_DEVICE Реализуется драйвером клиента и вызывается в результате вызова EVT_WDF_DEVICE_PREPARE_HARDWARE.
HWN_CLIENT_QUERY_DEVICE_INFORMATION Реализуется драйвером клиента для получения атрибутов компонента уведомлений оборудования.
HWN_CLIENT_SET_STATE Реализуется драйвером клиента для задания состояния компонента уведомлений оборудования. Он вызывается, когда пользователь хочет изменить состояние драйвера.
HWN_CLIENT_START_DEVICE Реализуется драйвером клиента для запуска компонента уведомлений оборудования. Он вызывается в результате вызова EVT_WDF_DEVICE_D0_ENTRY.
HWN_CLIENT_STOP_DEVICE Реализуется драйвером клиента ДЛЯ запуска компонента уведомления оборудования. Он вызывается в результате вызова EVT_WDF_DEVICE_D0_EXIT.
HWN_CLIENT_UNINITIALIZE_DEVICE Реализуется драйвером клиента и вызывается как вызванный в результате вызова EVT_WDF_DEVICE_RELEASE_HARDWARE. Эта функция обратного вызова неинициализирует компонент уведомления оборудования.

Структуры

CLIENT_DEVICE_INFORMATION Структура CLIENT_DEVICE_INFORMATION используется обратным вызовом уведомлений оборудования HWN_CLIENT_QUERY_DEVICE_INFORMATION для возврата общего количества уведомлений оборудования, предоставляемых драйвером клиентского устройства.
HWN_CLIENT_REGISTRATION_PACKET Пакет регистрации драйвера клиента уведомления оборудования, который передается расширению класса при регистрации драйвера клиента. Содержит сведения о версии и функции обратного вызова драйвера клиента.

Перечисления

HWN_CLX_EXPORT_INDEX Определяет позицию для каждого экспорта уведомлений об оборудовании в таблице экспорта.