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

ISensorDriver::OnSetProperties メソッドは、指定されたプロパティの一覧の値を指定します。

構文

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

パラメーター

[in] pClientFile

プロパティ値を指定するアプリケーションのファイル オブジェクトを表す IWDFFile インターフェイスへのポインター。

[in] pwszSensorID

クライアント アプリケーションがプロパティ値を指定しているセンサーの ID を含む LPWSTR。

[in] pPropertiesToSet

設定するプロパティとその値の一覧を含む IPortableDeviceValues インターフェイスへのポインター。

[out] ppResults

正常に設定されたプロパティとその新しい値の一覧を受け取る IPortableDeviceValues ポインターのアドレス。 プロパティが設定されていない場合、新しい値には HRESULT エラー コードが含まれます。

戻り値

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

注釈

プロパティは、センサーによって生成されたデータを含むデータ フィールドとは対照的に、センサー デバイスを表します。 プラットフォーム定義のプロパティは sensors.h で定義されます。

pPropertiesToSet を通じて提供されるプロパティのリストは、通常、ISensorDriver::OnGetSupportedProperties を通じて返されたリストのサブセットです。 ただし、センサー クラス拡張機能では、クライアント アプリケーションにこの条件は適用されません。

センサー クラス拡張機能は、このメソッドによって返される PROPVARIANT 構造体を解放する役割を担います。

IPortableDeviceValues については、「Windows ポータブル デバイス」を参照してください。

メモ このメソッドは、ユーザーが [場所] コントロール パネルと [その他 のセンサー] コントロール パネルでセンサーを有効にしている場合にのみ呼び出されます。

 

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows 7 で使用できます。
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	デスクトップ
Header	sensorsclassextension.h
Library	SensorsClassExtension.lib

こちらもご覧ください

ISensorDriver

ISensorDriver::OnGetProperties