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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | sensorsclassextension.h |
| Biblioteca | SensorsClassExtension.lib |