Método ISensorDriver::OnClientUnsubscribeFromEvents (sensorsclassextension.h)

O método ISensorDriver::OnClientUnsubscribeFromEvents notifica o driver do sensor de que um aplicativo cliente não solicita mais notificações de evento.

Sintaxe

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

pClientFile

Ponteiro para uma interface IWDFFile que representa o objeto de arquivo para o aplicativo que solicita o cancelamento de notificações de evento.

pwszSensorID

LPWSTR que contém a ID do sensor do qual o aplicativo cliente está solicitando o cancelamento de notificações de evento.

Se a operação for bem-sucedida, esse método retornará S_OK. Caso contrário, esse método retornará um dos códigos de erro definidos em Winerror.h.

A extensão da classe de sensor chama esse método nas seguintes instâncias:

Um aplicativo cancela a assinatura de eventos.
Um aplicativo fecha normalmente.
O usuário revoga a permissão para um aplicativo acessar o dispositivo que contém o sensor especificado.
A extensão de classe do sensor está sendo fechada.
O trabalho de limpeza de uma chamada para ISensorClassExtension::CleanupFile foi concluído.

Você pode usar essa chamada como um sinal para atualizar a contagem de referência de aplicativos que solicitam eventos para o sensor especificado.

Para obter mais informações sobre como usar esse método, consulte Filtrando dados.

A estrutura ClientData é definida da seguinte maneira.