ISensorDriver::OnClientSubscribeToEvents-Methode (sensorsclassextension.h)

Die ISensorDriver::OnClientSubscribeToEvents-Methode benachrichtigt den Sensortreiber, dass eine autorisierte Clientanwendung Ereignisbenachrichtigungen anfordert.

Syntax

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parameter

pClientFile

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

pwszSensorID

LPWSTR, das die ID für den Sensor enthält, von dem die Clientanwendung 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

Wenn eine Clientanwendung Ereignisbenachrichtigungen anfordert, löst der Treiber alle Ereignisse für die Sensorklassenerweiterung für die angegebene Objekt-ID aus. Die Klassenerweiterung leitet diese Ereignisse dann als Ereignisbenachrichtigungen für Anwendungen an die Sensor-API weiter.

Sie können eine Referenzanzahl verbundener Anwendungen für jeden Sensor verwalten, um Ereignisrückrufe zu vermeiden, wenn sie nicht erforderlich sind.

Plattformdefinierte Ereignisse werden in sensors.h definiert.

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

Anforderungen

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

Weitere Informationen

ISensorDriver