Método ISensorDriver::OnClientConnect (sensorsclassextension.h)
El método ISensorDriver::OnClientConnect notifica al controlador de sensor que una aplicación cliente se ha conectado.
Sintaxis
HRESULT OnClientConnect(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
Parámetros
pClientFile
Puntero a una interfaz IWDFFile que representa el objeto de archivo para la aplicación que solicita la conexión.
pwszSensorID
LPWSTR que contiene el identificador del sensor al que se conecta la aplicación cliente.
Valor devuelto
Si la operación se realiza correctamente, este método devuelve S_OK. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.
Comentarios
La extensión de clase sensor llama a este método solo si el usuario ha concedido permiso a la aplicación cliente especificada para acceder al controlador. Si el usuario revoca este permiso, la extensión de clase llama inmediatamente a ISensorDriver::OnClientDisconnect para el mismo par de aplicación o sensor.
La extensión de clase siempre llama a este método antes de llamar a ISensorDriver::OnSetProperties o ISensorDriver::OnGetDataFields para un sensor determinado. Se recomienda mantener un recuento de referencias de aplicaciones conectadas para ayudar a prever cuándo se pueden realizar llamadas a estos tres métodos. Si no hay ninguna aplicación cliente conectada, es posible que desee cambiar el comportamiento del controlador, por ejemplo, realizando pasos para reducir el consumo de energía.
Puede usar el valor de puntero (la dirección a la que apunta pClientFile ) como un tipo de identificador para realizar un seguimiento de las aplicaciones conectadas. Sin embargo, debe realizar un seguimiento de estos identificadores por separado para cada sensor, no para cada dispositivo, ya que la extensión de clase puede proporcionar el mismo valor de puntero a varios sensores en el mismo dispositivo.
Para obtener más información sobre cómo usar este método, consulte Filtrado de datos.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |