Condividi tramite


Metodo ISensorDriver::OnClientUnsubscribeFromEvents (sensorclassextension.h)

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

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 contenente l'ID per il 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.

Commenti

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

  • Un'applicazione annulla la sottoscrizione agli eventi.
  • Un'applicazione 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 è stato 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 Filtro dei dati.

La struttura ClientData è definita come indicato di seguito.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione sensorclassextension.h
Libreria SensorsClassExtension.lib

Vedi anche

ISensorDriver