ISensorDriver::OnClientSubscribeToEvents メソッド (sensorsclassextension.h)

ISensorDriver::OnClientSubscribeToEvents メソッドは、承認されたクライアントアプリケーションがイベント通知を要求していることをセンサードライバーに通知します。

構文

HRESULT OnClientSubscribeToEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

pClientFile

イベント通知を要求するアプリケーションのファイルオブジェクトを表す IWDFFile インターフェイスへのポインター。

pwszSensorID

クライアントアプリケーションがイベント通知を要求しているセンサーの ID を含む LPWSTR。

操作が成功した場合、このメソッドはS_OKを返します。それ以外の場合、このメソッドは Winerror.h で定義されているエラーコードの 1 つを返します。

クライアントアプリケーションがイベント通知を要求すると、ドライバーは、指定されたオブジェクト ID のセンサークラス拡張機能にすべてのイベントを発生させます。クラス拡張機能は、これらのイベントをアプリケーションのイベント通知として Sensor API に転送します。

不要な場合にイベントコールバックを行わないように、各センサーの接続されたアプリケーションの参照数を維持できます。

プラットフォーム定義イベントは sensors.h で定義されます。

このメソッドの使用方法の詳細については、「データのフィルター処理」を参照してください。