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.

Bemerkungen

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 für jeden Sensor eine Referenzanzahl der verbundenen Anwendungen 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-	Fenster
Header-	sensorsclassextension.h
Library	SensorsClassExtension.lib

Siehe auch

ISensorDriver-