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

O método ISensorDriver::OnClientConnect notifica o driver do sensor que um aplicativo cliente conectou.

Sintaxe

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parâmetros

pClientFile

Ponteiro para uma interface IWDFFile que representa o objeto de arquivo para o aplicativo que solicita a conexão.

pwszSensorID

LPWSTR que contém a ID do sensor ao qual o aplicativo cliente está se conectando.

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

A extensão de classe de sensor chamará esse método somente se o aplicativo cliente especificado tiver recebido permissão do usuário para acessar o driver. Se o usuário revogar essa permissão, a extensão de classe chamará imediatamente ISensorDriver::OnClientDisconnect para o mesmo par de aplicativos/sensores.

A extensão de classe sempre chama esse método antes de chamar ISensorDriver::OnSetProperties ou ISensorDriver::OnGetDataFields para um sensor específico. Recomendamos que você mantenha uma contagem de referência de aplicativos conectados para ajudar a prever quando as chamadas para esses três métodos são possíveis. Se nenhum aplicativo cliente estiver conectado, talvez você queira alterar o comportamento do driver, por exemplo, tomando medidas para reduzir o consumo de energia.

Você pode usar o valor do ponteiro (o endereço apontado) fornecido por pClientFile como uma espécie de ID para acompanhar os aplicativos conectados. No entanto, você deve rastrear essas IDs separadamente para cada sensor, não para cada dispositivo, pois a extensão de classe pode fornecer o mesmo valor de ponteiro para vários sensores no mesmo dispositivo.

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

Requisitos

Confira também

ISensorDriver