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

Этот заголовок определяет интерфейсы программирования, необходимые для обеспечения аппаратной поддержки компонентов уведомлений, таких как leD и механизмы вибрации. Эта поддержка предоставляется путем внедрения расширения класса 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

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