ISensorDriver::OnClientConnect-Methode (sensorsclassextension.h)

Die ISensorDriver::OnClientConnect-Methode benachrichtigt den Sensortreiber, dass eine Clientanwendung verbunden ist.

Syntax

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

Parameter

pClientFile

Zeiger auf eine IWDFFile-Schnittstelle, die das Dateiobjekt für die Anwendung darstellt, die die Verbindung anfordert.

pwszSensorID

LPWSTR, das die ID für den Sensor enthält, mit dem die Clientanwendung eine Verbindung herstellt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt diese Methode S_OK zurück. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Die Sensorklassenerweiterung ruft diese Methode nur auf, wenn der angegebenen Clientanwendung vom Benutzer die Berechtigung für den Zugriff auf den Treiber erteilt wurde. Wenn der Benutzer diese Berechtigung widerruft, ruft die Klassenerweiterung sofort ISensorDriver::OnClientDisconnect für dasselbe Anwendungs-Sensor-Paar auf.

Die Klassenerweiterung ruft diese Methode immer auf , bevor ISensorDriver::OnSetProperties oder ISensorDriver::OnGetDataFields für einen bestimmten Sensor aufgerufen wird. Es wird empfohlen, eine Referenzanzahl verbundener Anwendungen beizubehalten, um zu antizipieren, wann Aufrufe dieser drei Methoden möglich sind. Wenn keine Clientanwendungen verbunden sind, können Sie das Verhalten des Treibers ändern, z. B. indem Sie Schritte zur Reduzierung des Energieverbrauchs ergreifen.

Sie können den von pClientFile bereitgestellten Zeigerwert (die Adresse, auf die verwiesen wird) als eine Art ID verwenden, um verbundene Anwendungen nachzuverfolgen. Sie müssen diese IDs jedoch separat für jeden Sensor nachverfolgen, nicht für jedes Gerät, da die Klassenerweiterung möglicherweise denselben Zeigerwert für mehrere Sensoren auf demselben Gerät bereitstellt.

Weitere Informationen zur Verwendung dieser Methode finden Sie unter Filtern von Daten.

Anforderungen

Weitere Informationen

ISensorDriver