Функция UrsReportHardwareEvent (ursdevice.h)

Уведомляет расширение класса USB с двойной ролью о новом аппаратном событии.

Синтаксис

VOID UrsReportHardwareEvent(
  [in] WDFDEVICE          Device,
  [in] URS_HARDWARE_EVENT HardwareEvent
);

Параметры

[in] Device

Дескриптор объекта устройства платформы, полученный драйвером клиента в предыдущем вызове WdfDeviceCreate.

[in] HardwareEvent

Значение типа URS_HARDWARE_EVENT, указывающее тип события, которое произошло.

Возвращаемое значение

Никакой

Замечания

Прежде чем сообщать о каких-либо событиях оборудования, драйвер клиента для контроллера двойной роли должен указать расширение класса, которое драйвер поддерживает события оборудования, вызывая UrsSetHardwareEventSupport.

Драйвер клиента не может передать UrsHardwareEventNone в качестве значения параметра HardwareEvent. Это значение зарезервировано для внутреннего использования.

Драйвер клиента должен вызвать этот метод, чтобы сообщить о любом аппаратном событии, например прерываниях с закреплением идентификатора. Как правило, в реализации драйвера обратного вызова EvtInterruptIsr драйвер считывает состояние пин-кода и сообщает о событии расширению класса путем вызова этого метода.

Требования

См. также

• WdfDeviceCreate
• URS_HARDWARE_EVENT
• UrsSetHardwareEventSupport
• EvtInterruptIsr