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 |