Метод ISensorDriver::OnClientUnsubscribeFromEvents (sensorsclassextension.h)

  • Статья

Метод ISensorDriver::OnClientUnsubscribeFromEvents уведомляет драйвер датчика о том, что клиентское приложение больше не запрашивает уведомления о событиях.

Синтаксис

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Параметры

pClientFile

Указатель на интерфейс IWDFFile, представляющий объект файла для приложения, запрашивающего отмену уведомлений о событиях.

pwszSensorID

LPWSTR, содержащий идентификатор датчика, с которого клиентское приложение запрашивает отмену уведомлений о событиях.

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

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

Комментарии

Расширение класса датчика вызывает этот метод в следующих экземплярах:

  • Приложение отменяет подписку на события.
  • Приложение закрывается в обычном режиме.
  • Пользователь отменяет у приложения разрешение на доступ к устройству, содержатму датчику.
  • Расширение класса датчика завершает работу.
  • Работа по очистке при вызове метода ISensorClassExtension::CleanupFile завершена.
Этот вызов можно использовать в качестве сигнала для обновления количества ссылок приложений, запрашивающих события для указанного датчика.

Дополнительные сведения об использовании этого метода см. в разделе Фильтрация данных.

Структура ClientData определяется следующим образом.

Требования

Требование Значение
Целевая платформа Windows
Header sensorsclassextension.h
Библиотека SensorsClassExtension.lib

См. также раздел

ISensorDriver