ISensorDriver::OnClientSubscribeToEvents メソッド (sensorsclassextension.h)
ISensorDriver::OnClientSubscribeToEvents メソッドは、承認されたクライアント アプリケーションがイベント通知を要求していることをセンサー ドライバーに通知します。
構文
HRESULT OnClientSubscribeToEvents(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
パラメーター
pClientFile
イベント通知を要求するアプリケーションのファイル オブジェクトを表す IWDFFile インターフェイスへのポインター。
pwszSensorID
クライアント アプリケーションがイベント通知を要求するセンサーの ID を含む LPWSTR。
戻り値
操作が成功した場合、このメソッドは S_OKを返します。 それ以外の場合、このメソッドは Winerror.h で定義されているエラー コードのいずれかを返します。
注釈
クライアント アプリケーションがイベント通知を要求すると、ドライバーは、指定されたオブジェクト ID のセンサー クラス拡張機能にすべてのイベントを発生させます。 その後、クラス拡張機能は、これらのイベントをアプリケーションのイベント通知として Sensor API に転送します。
不要な場合にイベント コールバックを行わないように、センサーごとに接続されているアプリケーションの参照カウントを維持できます。
プラットフォーム定義イベントは sensors.h で定義されます。
このメソッドの使用方法の詳細については、「 データのフィルター処理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |