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

  • [アーティクル]

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

構文

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

パラメーター

pClientFile

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

pwszSensorID

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

戻り値

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

注釈

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

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

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

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

要件

要件 値
対象プラットフォーム Windows
ヘッダー sensorsclassextension.h
Library SensorsClassExtension.lib

こちらもご覧ください

ISensorDriver