ISensorDriver::OnClientUnsubscribeFromEvents-Methode (sensorsclassextension.h)

Die ISensorDriver::OnClientUnsubscribeFromEvents-Methode benachrichtigt den Sensortreiber, dass eine Clientanwendung keine Ereignisbenachrichtigungen mehr anfordert.

Syntax

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parameter

pClientFile

Zeiger auf eine IWDFFile-Schnittstelle, die das Dateiobjekt für die Anwendung darstellt, die den Abbruch von Ereignisbenachrichtigungen anfordert.

pwszSensorID

LPWSTR, das die ID für den Sensor enthält, von dem die Clientanwendung den Abbruch von Ereignisbenachrichtigungen anfordert.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt diese Methode S_OK zurück. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Die Sensorklassenerweiterung ruft diese Methode in den folgenden Instanzen auf:

  • Eine Anwendung gekündigt Ereignisse.
  • Eine Anwendung wird normal geschlossen.
  • Der Benutzer widerruft die Berechtigung für eine Anwendung für den Zugriff auf das Gerät, das den angegebenen Sensor enthält.
  • Die Sensorklassenerweiterung wird heruntergefahren.
  • Die Bereinigungsarbeiten aus einem Aufruf von ISensorClassExtension::CleanupFile wurden abgeschlossen.
Sie können diesen Aufruf als Signal verwenden, um die Referenzanzahl von Anwendungen zu aktualisieren, die Ereignisse für den angegebenen Sensor anfordern.

Weitere Informationen zur Verwendung dieser Methode finden Sie unter Filtern von Daten.

Die ClientData-Struktur ist wie folgt definiert.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile sensorsclassextension.h
Bibliothek SensorsClassExtension.lib

Weitere Informationen

ISensorDriver