Condividi tramite


Metodo ISensorDriver::OnClientUnsubscribeFromEvents (sensorsclassextension.h)

Il metodo ISensorDriver::OnClientUnsubscribeFromEvents notifica al driver del sensore che un'applicazione client non richiede più notifiche degli eventi.

Sintassi

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parametri

pClientFile

Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che richiede l'annullamento delle notifiche degli eventi.

pwszSensorID

LPWSTR che contiene l'ID del sensore da cui l'applicazione client richiede l'annullamento delle 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.

Osservazioni

L'estensione della classe del sensore chiama questo metodo nelle istanze seguenti:

  • Un'applicazione annulla la sottoscrizione agli eventi.
  • Un'applicazione si chiude normalmente.
  • L'utente revoca l'autorizzazione per un'applicazione per accedere al dispositivo che contiene il sensore specificato.
  • L'estensione della classe del sensore viene arrestata.
  • Il lavoro di pulizia da una chiamata a ISensorClassExtension::CleanupFile completato.
È possibile usare questa chiamata come segnale per aggiornare il numero di riferimenti delle applicazioni che richiedono eventi per il sensore specificato.

Per altre informazioni su come usare questo metodo, vedere Filtrare i dati.

La struttura ClientData è definita come segue.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione sensorsclassextension.h
libreria SensorsClassExtension.lib

Vedere anche

ISensorDriver