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 で定義されているエラー コードの 1 つを返します。

備考

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

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

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

IPortableDeviceValues については、Windows ポータブル デバイスに関する記事を参照してください。

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

 

必要条件

要件	価値
サポートされる最小クライアント	Windows 7、Windows 7 で使用できます。
サポートされる最小サーバー	サポートされていません
ターゲット プラットフォーム の	デスクトップ
ヘッダー	sensorsclassextension.h
ライブラリ	SensorsClassExtension.lib

関連項目

ISensorDriver を する

ISensorDriver::OnGetProperties