Metodo ISensorDriver::OnClientSubscribeToEvents (sensorsclassextension.h)
Il metodo ISensorDriver::OnClientSubscribeToEvents notifica al driver del sensore che un'applicazione client autorizzata richiede notifiche degli eventi.
Sintassi
HRESULT OnClientSubscribeToEvents(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
Parametri
pClientFile
Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che richiede notifiche degli eventi.
pwszSensorID
LPWSTR che contiene l'ID per il sensore da cui l'applicazione client richiede notifiche degli eventi.
Valore restituito
Se l'operazione ha esito positivo, questo metodo restituisce S_OK. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.
Commenti
Quando un'applicazione client richiede notifiche di evento, il driver genera tutti gli eventi all'estensione della classe del sensore per l'ID oggetto specificato. L'estensione della classe inoltra quindi questi eventi all'API Sensor come notifiche degli eventi per le applicazioni.
È possibile mantenere un conteggio dei riferimenti delle applicazioni connesse per ogni sensore per evitare di effettuare callback degli eventi quando non è necessario.
Gli eventi definiti dalla piattaforma sono definiti in sensors.h.
Per altre informazioni su come usare questo metodo, vedere Filtro dei dati.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | sensorsclassextension.h |
| Libreria | SensorsClassExtension.lib |