Поделиться через

Метод IStiUSD::SetNotificationHandle (stiusd.h)

  • Статья

Метод minidriver по-прежнему IStiUSD::SetNotificationHandle указывает дескриптор событий, который должен использовать мини-driver для информирования вызывающего события устройства.

Синтаксис

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Параметры

hEvent

Вызываемый дескриптор события Win32, созданный путем вызова CreateEvent.

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

Если операция выполнена успешно, метод должен вернуть S_OK. В противном случае он должен возвращать один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Если драйвер (и устройство) поддерживает асинхронное уведомление события устройства по-прежнему образов, метод IStiUSD::SetNotificationHandle является средством, с помощью которого монитор событий запрашивает драйвер уведомлять его о возникновении события.

Если hEvent является дескриптором событий, метод IStiUSD::SetNotificationHandle должен хранить дескриптор и использовать его в качестве входного аргумента для SetEvent (описано в документации по пакету SDK для Microsoft Windows). Драйвер должен вызывать SetEvent каждый раз при обнаружении события устройства, чтобы уведомить монитор событий о том, что произошло событие.

Если hEventNULL, метод должен отключить уведомление о событиях устройства.

Требования

Требование Ценность
целевая платформа Настольный
заголовка stiusd.h (include Stiusd.h)