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

ISensorDriver::OnClientConnect メソッドは、クライアント アプリケーションが接続したことをセンサー ドライバーに通知します。

構文

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

パラメーター

pClientFile

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

pwszSensorID

クライアント アプリケーションが接続しているセンサーの ID を含む LPWSTR。

戻り値

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

備考

センサー クラス拡張機能は、指定したクライアント アプリケーションにドライバーへのアクセス許可がユーザーから付与されている場合にのみ、このメソッドを呼び出します。 ユーザーがこのアクセス許可を取り消した場合、クラス拡張機能は、同じアプリケーション/センサー ペアに対 ISensorDriver::OnClientDisconnect をすぐに呼び出します。

クラス拡張機能は、特定のセンサー ISensorDriver::OnSetProperties または ISensorDriver::OnGetDataFields を呼び出す前に、常にこのメソッドを呼び出します。 これら 3 つのメソッドの呼び出しが可能なタイミングを予測できるように、接続されているアプリケーションの参照カウントを維持することをお勧めします。 クライアント アプリケーションが接続されていない場合は、たとえば、電力消費量を削減する手順を実行して、ドライバーの動作を変更できます。

接続されたアプリケーションを追跡するために、pClientFile によって提供されるポインター値 (指すアドレス) を ID の一種として使用できます。 ただし、クラス拡張機能は同じデバイス上の複数のセンサーに同じポインター値を提供する可能性があるため、デバイスごとにではなく、センサーごとにこれらの ID を個別に追跡する必要があります。

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

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	sensorsclassextension.h
ライブラリ	SensorsClassExtension.lib

関連項目

ISensorDriver を する