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

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

  • Статья

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

Синтаксис

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

Параметры

hEvent

Предоставленный вызывающей стороной дескриптор события Win32, созданный путем вызова Метода CreateEvent.

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

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

Комментарии

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть stiusd.h (включая Stiusd.h)