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

O método ISensorDriver::OnClientSubscribeToEvents notifica o driver do sensor de que um aplicativo cliente autorizado está solicitando notificações de evento.

Sintaxe

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parâmetros

pClientFile

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

pwszSensorID

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

Retornar valor

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.

Comentários

Quando um aplicativo cliente solicita notificações de evento, o driver gera todos os eventos para a extensão de classe de sensor para a ID de objeto especificada. Em seguida, a extensão de classe encaminha esses eventos para a API do Sensor como notificações de evento para aplicativos.

Você pode manter uma contagem de referência de aplicativos conectados para cada sensor para evitar fazer retornos de chamada de evento quando não for necessário.

Os eventos definidos pela plataforma são definidos em sensors.h.

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

Requisitos

Confira também

ISensorDriver